DacServices.Deploy Méthode

Définition

Espace de noms:: Microsoft.SqlServer.Dac

Assembly:: Microsoft.SqlServer.Dac.dll

Paquet:: Microsoft.SqlServer.DacFx.x64 v140.3881.1

Paquet:: Microsoft.SqlServer.DacFx v150.5282.3

Paquet:: Microsoft.SqlServer.DacFx v160.6161.0

Paquet:: Microsoft.SqlServer.DacFx v162.2.111

Paquet:: Microsoft.Data.Tools.Msbuild v10.0.61804.210

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Déployez le package fourni dans une base de données.

public void Deploy(Microsoft.SqlServer.Dac.DacPackage package, string targetDatabaseName, bool upgradeExisting = false, Microsoft.SqlServer.Dac.DacDeployOptions options = default, System.Threading.CancellationToken? cancellationToken = default);

member this.Deploy : Microsoft.SqlServer.Dac.DacPackage * string * bool * Microsoft.SqlServer.Dac.DacDeployOptions * Nullable<System.Threading.CancellationToken> -> unit

Public Sub Deploy (package As DacPackage, targetDatabaseName As String, Optional upgradeExisting As Boolean = false, Optional options As DacDeployOptions = Nothing, Optional cancellationToken As Nullable(Of CancellationToken) = Nothing)

Paramètres

package: DacPackage

DacPackage contenant le schéma à déployer.

targetDatabaseName: String

Nom de la base de données cible pour le déploiement.

upgradeExisting: Boolean

True pour autoriser la modification du schéma de base de données existant afin de faire correspondre le schéma contenu dans le package source ; sinon false pour bloquer la modification de la base de données existante. Si la base de données n’existe pas, cet indicateur n’a aucun effet.

options: DacDeployOptions

Instance de DacDeployOptions ce qui spécifie les propriétés qui affectent différents aspects du déploiement.

cancellationToken: Nullable<CancellationToken>

Facultatif CancellationToken qui peut être utilisé pour indiquer que l’opération doit être annulée. L’utilisation de cet objet ne garantit pas que l’opération sera annulée.

Exceptions

ArgumentException

Si la valeur de l’un des paramètres requis est une référence Null ou une chaîne vide.

DacServicesException

Si upgradeExisting la valeur est true et que la base de données cible existe ; ou si une erreur se produit pendant le déploiement.

OperationCanceledException

Si l’annulation CancellationToken a été demandée et que l’opération peut être annulée.

S’applique à