DacPackageExtensions.UpdateModel メソッド

現在のモデルを新しいモデルと置き換えて、DacPackage 内のモデルを更新します。 更新する前に、モデルが検証され、エラーが発生した場合は DacServicesException がスローされます。 呼び出し元は警告およびエラーをブロックする場合、Validate() を呼び出し、返されるメッセージにエラーまたは警告が含まれるかどうかを確認することで、モデルを検証する必要があります。 注: モデルだけが置き換えられます。リファクター ログ、配置前スクリプト、配置後スクリプトなど、コントリビューターなどのその他の成果物はすべて変更されません。 これらの成果物のいずれかが依存する要素が、更新されたモデルに存在しない場合、配置に失敗する可能性があります。 呼び出し元は、これらの成果物が新しいモデルと一貫性を持つようにする必要があります。 Package API を使用すると、リファクター ログやスクリプトなどのその他の成果物を更新し、更新されたモデルとの一貫性を保持することができます。 これらの成果物はパッケージの一部として格納され、URI で識別されます。 パッケージの一部は、GetParts() を使用して調べることができます。 パッケージの一部の更新の詳細については、Package API を参照してください。

名前空間:  Microsoft.SqlServer.Dac
アセンブリ:  Microsoft.SqlServer.Dac.Extensions (Microsoft.SqlServer.Dac.Extensions.dll)

構文

'宣言
<ExtensionAttribute> _
Public Shared Sub UpdateModel ( _
    dacPackage As DacPackage, _
    newModel As TSqlModel, _
    packageMetadata As PackageMetadata _
)
'使用
Dim dacPackage As DacPackage 
Dim newModel As TSqlModel 
Dim packageMetadata As PackageMetadata 

dacPackage.UpdateModel(newModel, _
    packageMetadata)

public static void UpdateModel(
    this DacPackage dacPackage,
    TSqlModel newModel,
    PackageMetadata packageMetadata
)

[ExtensionAttribute]
public:
static void UpdateModel(
    DacPackage^ dacPackage, 
    TSqlModel^ newModel, 
    PackageMetadata^ packageMetadata
)

static member UpdateModel : 
        dacPackage:DacPackage * 
        newModel:TSqlModel * 
        packageMetadata:PackageMetadata -> unit

public static function UpdateModel(
    dacPackage : DacPackage, 
    newModel : TSqlModel, 
    packageMetadata : PackageMetadata
)

パラメーター

• dacPackage
  型: Microsoft.SqlServer.Dac.DacPackage
  更新する DacPackage。

• newModel
  型: Microsoft.SqlServer.Dac.Model.TSqlModel
  パッケージに保存するモデルを表す TSqlModel。

• packageMetadata
  型: Microsoft.SqlServer.Dac.PackageMetadata
  DacPackage に使用する名前、バージョン、および説明を表す PackageMetadata。パッケージ情報を変更しない場合は null。

使用に関するメモ

Visual Basic および C# では、このメソッドを型 DacPackage の任意のオブジェクトのインスタンス メソッドとして呼び出すことができます。このメソッドを呼び出すためにインスタンス メソッドの構文を使う場合は、最初のパラメーターを省略してください。詳細については、「b8020aae-374d-46a9-bcb7-8cc2390b93b6」または「175ce3ff-9bbf-4e64-8421-faeb81a0bb51」を参照してください。

例外

関連項目

参照

DacPackageExtensions クラス

Microsoft.SqlServer.Dac 名前空間