指定されたパッケージをデータベースに配置します。
名前空間: Microsoft.SqlServer.Dac
アセンブリ: Microsoft.SqlServer.Dac (Microsoft.SqlServer.Dac.dll)
構文
'宣言
Public Sub Deploy ( _
package As DacPackage, _
targetDatabaseName As String, _
upgradeExisting As Boolean, _
options As DacDeployOptions, _
cancellationToken As Nullable(Of CancellationToken) _
)
'使用
Dim instance As DacServices
Dim package As DacPackage
Dim targetDatabaseName As String
Dim upgradeExisting As Boolean
Dim options As DacDeployOptions
Dim cancellationToken As Nullable(Of CancellationToken)
instance.Deploy(package, targetDatabaseName, _
upgradeExisting, options, cancellationToken)
public void Deploy(
DacPackage package,
string targetDatabaseName,
bool upgradeExisting,
DacDeployOptions options,
Nullable<CancellationToken> cancellationToken
)
public:
void Deploy(
DacPackage^ package,
String^ targetDatabaseName,
bool upgradeExisting,
DacDeployOptions^ options,
Nullable<CancellationToken> cancellationToken
)
member Deploy :
package:DacPackage *
targetDatabaseName:string *
upgradeExisting:bool *
options:DacDeployOptions *
cancellationToken:Nullable<CancellationToken> -> unit
public function Deploy(
package : DacPackage,
targetDatabaseName : String,
upgradeExisting : boolean,
options : DacDeployOptions,
cancellationToken : Nullable<CancellationToken>
)
パラメーター
- package
型: Microsoft.SqlServer.Dac.DacPackage
配置するスキーマを保持する DacPackage。
- targetDatabaseName
型: System.String
配置のターゲット データベースの名前。
- upgradeExisting
型: System.Boolean
ソース パッケージに含まれているスキーマに合わせて既存のデータベース スキーマを変更する場合は true、それ以外の場合 (既存のデータベースを変更できないようにする場合) は false。 データベースが存在しない場合、このフラグは一切作用しません。
- options
型: Microsoft.SqlServer.Dac.DacDeployOptions
配置のさまざまな側面についてのプロパティを指定する DacDeployOptions のインスタンス。
- cancellationToken
型: System.Nullable<CancellationToken>
操作を取り消す際に使用できる CancellationToken (省略可)。 このオブジェクトを使用しても、操作が確実に取り消される保証はありません。
例外
| 例外 | 条件 |
|---|---|
| ArgumentException | いずれかの必須のパラメーターの値が null 参照か、空の文字列である場合に発生します。 |
| DacServicesException | upgradeExisting |
| OperationCanceledException |