Package.EnableConfigurations Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica se il pacchetto carica configurazioni.
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, setPublic Property EnableConfigurations As BooleanValore della proprietà
true se il pacchetto carica le configurazioni; in caso contrario, false.
- Attributi
Esempio
Nell'esempio seguente viene creato un nuovo pacchetto e quindi viene impostato su EnableConfigurationstrue, nonché sulla ExportConfigurationFile proprietà . Nell'esempio viene quindi aggiunta una nuova configurazione al pacchetto e viene impostato il valore di diverse proprietà.
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.
Commenti
Se questa proprietà è impostata su false, verranno usati i valori salvati in modo permanente nel pacchetto, anziché sovrascritti dalle configurazioni caricate.
Quando si distribuisce il pacchetto, è possibile impostarlo su false con l'ultima configurazione. Quindi, quando il pacchetto viene eseguito per la prima volta dopo la distribuzione, i valori del pacchetto verranno sovrascritti una volta dai valori di configurazione. Per altre informazioni sulle configurazioni usate da un pacchetto, vedere Creare configurazioni pacchetto.