Package.EnableConfigurations Proprietà

Definizione

Spazio dei nomi:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

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, set

Public Property EnableConfigurations As Boolean

Valore della proprietà

Boolean

Vero se il pacchetto carica configurazioni; altrimenti, falso.

Attributi: LocalizablePropertyDescriptionAttribute

Esempio

Il seguente esempio crea un nuovo package e poi imposta il EnableConfigurations , trueoltre alla ExportConfigurationFile proprietà. L'esempio aggiunge quindi una nuova configurazione al pacchetto e imposta 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 a false, i valori persistenti nel pacchetto saranno usati, invece di essere sovrascritti dalle configurazioni caricate.

Quando distribuisci il pacchetto, puoi impostare questo con false l'ultima configurazione. Poi, quando il pacchetto viene eseguito per la prima volta dopo il deployment, i valori del pacchetto verranno sovrascritti una volta dai valori di configurazione. Per maggiori informazioni sulle configurazioni utilizzate da un pacchetto, vedi Crea configurazioni di pacchetto.

Si applica a