Package.EnableConfigurations プロパティ
パッケージが構成を読み込むかどうかを示す値を取得または設定します。
名前空間: Microsoft.SqlServer.Dts.Runtime
アセンブリ: Microsoft.SqlServer.ManagedDTS (Microsoft.SqlServer.ManagedDTS.dll)
構文
'宣言
Public Property EnableConfigurations As Boolean
Get
Set
'使用
Dim instance As Package
Dim value As Boolean
value = instance.EnableConfigurations
instance.EnableConfigurations = value
public bool EnableConfigurations { get; set; }
public:
property bool EnableConfigurations {
bool get ();
void set (bool value);
}
member EnableConfigurations : bool with get, set
function get EnableConfigurations () : boolean
function set EnableConfigurations (value : boolean)
プロパティ値
型: System.Boolean
パッケージが構成を読み込む場合は true、それ以外の場合は false。
説明
このプロパティが false に設定されている場合は、読み込まれた構成により上書きされるのではなく、パッケージに保存されている値が使用されます。
パッケージを配置する際、最後の構成でこれを false に設定できます。 こうすると、配置後初めてパッケージが実行される際に、パッケージの値が構成値で一度上書きされます。 パッケージにより使用される構成の詳細については、「パッケージ構成を作成する」を参照してください。
使用例
次の例では、新しいパッケージを作成し、ExportConfigurationFile プロパティと同様に EnableConfigurations を 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.