DacServices.Deploy Methode

Definition

Namespace:: Microsoft.SqlServer.Dac

Assembly:: Microsoft.SqlServer.Dac.dll

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

Paket:: Microsoft.SqlServer.DacFx v150.5282.3

Paket:: Microsoft.SqlServer.DacFx v160.6161.0

Paket:: Microsoft.SqlServer.DacFx v162.2.111

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellen Sie das bereitgestellte Paket in einer Datenbank bereit.

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)

Parameter

package: DacPackage

DacPackage das schema enthält, das bereitgestellt werden soll.

targetDatabaseName: String

Name der Zieldatenbank für die Bereitstellung.

upgradeExisting: Boolean

True, um die Änderung des vorhandenen Datenbankschemas zuzulassen, um das schema abzugleichen, das im Quellpaket enthalten ist; andernfalls "false", um die Änderung der vorhandenen Datenbank zu blockieren. Wenn die Datenbank nicht vorhanden ist, hat dieses Flag keine Auswirkung.

options: DacDeployOptions

Instanz, die DacDeployOptions Eigenschaften angibt, die sich auf verschiedene Aspekte der Bereitstellung auswirken.

cancellationToken: Nullable<CancellationToken>

Optional CancellationToken , das verwendet werden kann, um anzugeben, dass der Vorgang abgebrochen werden soll. Die Verwendung dieses Objekts garantiert nicht, dass der Vorgang abgebrochen wird.

Ausnahmen

ArgumentException

Wenn der Wert für einen der erforderlichen Parameter ein Nullverweis oder eine leere Zeichenfolge ist.

DacServicesException

Ist upgradeExisting "true" und die Zieldatenbank vorhanden, oder tritt während der Bereitstellung ein Fehler auf.

OperationCanceledException

Wenn ein CancellationToken Abbruch angefordert wurde und der Vorgang abgebrochen werden kann.

Gilt für: