次の方法で共有

  • [アーティクル]

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

使用例

次の例では、新しいパッケージを作成し、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.