Package.EnableConfigurations Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft einen Wert ab, der angibt, ob das Paket Konfigurationen lädt, oder legt ihn fest.
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
Eigenschaftswert
true, wenn das Paket Konfigurationen lädt; andernfalls false.
- Attribute
Beispiele
Im folgenden Beispiel wird ein neues Paket erstellt und dann die Eigenschaft auf , sowie auf EnableConfigurationstrue
die ExportConfigurationFile Eigenschaft festgelegt. Im Beispiel wird dem Paket dann eine neue Konfiguration hinzugefügt und der Wert mehrerer Eigenschaften festgelegt.
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.
Hinweise
Wenn diese Eigenschaft auf false
festgelegt ist, werden die beibehaltenen Werte im Paket verwendet, anstatt von den geladenen Konfigurationen überschrieben zu werden.
Beim Bereitstellen des Pakets können Sie dies mit false
der letzten Konfiguration festlegen. Wenn das Paket nach der Bereitstellung zuerst ausgeführt wird, werden die Paketwerte einmal durch die Konfigurationswerte überschrieben. Weitere Informationen zu konfigurationen, die von einem Paket verwendet werden, finden Sie unter Erstellen von Paketkonfigurationen.