Package.EnableConfigurations プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
パッケージが設定を読み込むかどうかを示す値を取得または設定します。
public:
property bool EnableConfigurations { bool get(); void set(bool value); };[Microsoft.SqlServer.Dts.Runtime.Localization.LocalizablePropertyDescription(typeof(Microsoft.SqlServer.Dts.Runtime.Localized), "EnableConfigurationsDesc")]
public bool EnableConfigurations { get; set; }[<Microsoft.SqlServer.Dts.Runtime.Localization.LocalizablePropertyDescription(typeof(Microsoft.SqlServer.Dts.Runtime.Localized), "EnableConfigurationsDesc")>]
member this.EnableConfigurations : bool with get, setPublic Property EnableConfigurations As Booleanプロパティ値
パッケージが構成を読み込む場合は真です。そうでなければ、誤りです。
- 属性
例
以下の例では新しいパッケージを作成し、 EnableConfigurations を trueに設定し、 ExportConfigurationFile プロパティも同様に設定します。 その後、この例はパッケージに新しい構成を追加し、いくつかのプロパティの値を設定します。
Package pkg = new Package();
pkg.EnableConfigurations = true;
pkg.ExportConfigurationFile("conf.xml");
// Create a variable object and add it to the
// package Variables collection.
Variable varPkg = pkg.Variables.Add("var", false, "", 100);
varPkg.Value = 1;
string packagePathToVariable = varPkg.GetPackagePath();
Configuration config = pkg.Configurations.Add();
config.ConfigurationString = "conf.xml";
config.ConfigurationType = DTSConfigurationType.ConfigFile;
config.PackagePath = packagePathToVariable;
// more code here.
Dim pkg As Package = New Package()
pkg.EnableConfigurations = True
pkg.ExportConfigurationFile("conf.xml")
' Create a variable object and add it to the
' package Variables collection.
Dim varPkg As Variable = pkg.Variables.Add("var",False,"",100)
varPkg.Value = 1
Dim packagePathToVariable As String = varPkg.GetPackagePath()
Dim config As Configuration = pkg.Configurations.Add()
config.ConfigurationString = "conf.xml"
config.ConfigurationType = DTSConfigurationType.ConfigFile
config.PackagePath = packagePathToVariable
' more code here.
注釈
このプロパティが falseに設定されている場合、パッケージ内の永続的な値が使用され、ロードされた構成によって上書きされることはありません。
パッケージを展開する際に、これを最後の設定で false に設定できます。 その後、デプロイ後にパッケージが最初に実行されると、パッケージ値は設定値によって一度だけ上書きされます。 パッケージで使用される構成についての詳細は 、「パッケージ構成の作成」をご覧ください。