DeploymentContributorConfigurationStream クラス

配置およびビルド プロセスで DacFx によって使用される構成ファイルのストリーミング可能なバージョンを表します。 これらのストリームを使用すると、デプロイ拡張機能を使用して、設計とデプロイのエクスペリエンスを強化および拡張できます。

入力構成ファイルは、MSBuild プロセスの一部として .sqlproj ファイルで定義できます。 ファイルはストリームとして扱われ、 Microsoft.SqlServer.Dac.Deployment.DeploymentContributor.EstablishDeploymentConfiguration(Microsoft.SqlServer.Dac.Deployment.DeploymentContributorConfigurationSetup) メソッドを介して共同作成者に渡されます。このメソッドは、生成された dacpac に格納されている出力としてコピーできます。

これらのストリームは、デプロイ時に構成とデータに使用できる Microsoft.SqlServer.Dac.Deployment.DeploymentContributor.ApplyDeploymentConfiguration(Microsoft.SqlServer.Dac.Deployment.DeploymentContributorContext,System.Collections.Generic.ICollection{Microsoft.SqlServer.Dac.Deployment.DeploymentContributorConfigurationStream})で使用できるようになります。 Microsoft.SqlServer.Dac.Deployment.DeploymentContributor.ApplyDeploymentConfiguration(Microsoft.SqlServer.Dac.Deployment.DeploymentContributorContext,System.Collections.Generic.ICollection{Microsoft.SqlServer.Dac.Deployment.DeploymentContributorConfigurationStream})メソッドの最後に、すべてのストリームが破棄されます。 ストリームからデータを取得する必要がある共同作成者は、このメソッドの間にデータを読み取ってキャッシュする必要があります。 OnExecute(DeploymentPlanContributorContext) メソッドの間にストリームから読み取ろうとすると失敗します。

.sqproj ファイル内では、配置構成ファイルは次のように指定されます。 <ItemGroup><DeploymentExtensionConfiguration Include="MyContributorName.MyFileName1.sql" /><DeploymentExtensionConfiguration Include="MyContributorName.MyFileName2.sql" /></ItemGroup>

構成ストリームには、すべての共同作成者がアクセスできます。 共同作成者は、ファイルの名前付けパターンを使用して、その共同作成者に関連する入力ファイルを識別できます。