Package.EnableConfigurations プロパティ

定義

名前空間:

Microsoft.SqlServer.Dts.Runtime

アセンブリ:

Microsoft.SqlServer.ManagedDTS.dll

パッケージが構成を読み込むかどうかを示す値を取得または設定します。

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, set

Public Property EnableConfigurations As Boolean

プロパティ値

Boolean

パッケージが構成を読み込む場合は true。それ以外の場合は false。

属性

LocalizablePropertyDescriptionAttribute

例

次の例では、新しいパッケージを作成し、EnableConfigurations プロパティと同様に ExportConfigurationFile を true に設定します。 次に、パッケージに新しい構成を追加し、いくつかのプロパティの値を設定します。

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 に設定できます。 こうすると、配置後初めてパッケージが実行される際に、パッケージの値が構成値で一度上書きされます。 パッケージで使用される構成の詳細については、「パッケージ構成の 作成」を参照してください。