Package.EnableConfigurations Property

パッケージが構成を読み込むかどうかを示します。

名前空間: Microsoft.SqlServer.Dts.Runtime
アセンブリ: Microsoft.SqlServer.ManagedDTS (microsoft.sqlserver.manageddts.dll 内)

構文

'宣言
Public Property EnableConfigurations As Boolean

public bool EnableConfigurations { get; set; }

public:
property bool EnableConfigurations {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_EnableConfigurations ()

/** @property */
public void set_EnableConfigurations (boolean value)

public function get EnableConfigurations () : boolean

public function set EnableConfigurations (value : 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.

スレッド セーフ

この型の public static (Microsoft Visual Basic では共有 ) メンバは、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

開発プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

対象プラットフォーム

サポートされているプラットフォームの一覧については、「SQL Server 2005 のインストールに必要なハードウェアおよびソフトウェア」を参照してください。

参照

関連項目

Package Class
Package Members
Microsoft.SqlServer.Dts.Runtime Namespace