Configuration Classe

Riferimento

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.

Rappresenta una classe di configurazione che contiene informazioni sulla configurazione di un pacchetto. La classe non può essere ereditata.

public ref class Configuration sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject, Microsoft::SqlServer::Dts::Runtime::IDTSName, Microsoft::SqlServer::Dts::Runtime::IDTSPersist

public sealed class Configuration : Microsoft.SqlServer.Dts.Runtime.DtsObject, Microsoft.SqlServer.Dts.Runtime.IDTSName, Microsoft.SqlServer.Dts.Runtime.IDTSPersist

type Configuration = class
    inherit DtsObject
    interface IDTSPersist
    interface IDTSName

Public NotInheritable Class Configuration
Inherits DtsObject
Implements IDTSName, IDTSPersist

Ereditarietà: Object

DtsObject
Configuration

Implementazioni: IDTSName IDTSPersist

Commenti

Le configurazioni sono utili durante la distribuzione di pacchetti in molti server diversi e semplificano lo spostamento dei pacchetti da sviluppo a ambienti di produzione.

È possibile usare le variabili per aggiornare i pacchetti in modo dinamico, che consente di personalizzare la funzionalità del pacchetto e adattare i pacchetti agli ambienti in cui vengono eseguiti. Per aggiornare le proprietà del pacchetto in fase di esecuzione usando le variabili, eseguire il mapping delle variabili alle proprietà dell'oggetto pacchetto, creare configurazioni per le variabili, distribuire le configurazioni con il pacchetto e quindi aggiornare i valori delle variabili nel file di configurazione in base al nuovo ambiente. In fase di esecuzione, il pacchetto usa automaticamente i valori aggiornati. Questa flessibilità è utile quando i pacchetti distribuiti si connettono a server diversi, eseguono istruzioni SQL diverse o eseguono pacchetti figlio diversi. Per altre informazioni, vedere Creare configurazioni dei pacchetti e usare variabili nei pacchetti.

Proprietà

ConfigurationString	Ottiene o imposta la posizione della configurazione.
ConfigurationType	Ottiene o imposta un valore dell'oggetto DTSConfigurationType che descrive in quale tipo di file vengono archiviate le informazioni di configurazione.
CreationName	Restituisce la stringa utilizzata dal motore di runtime per creare un'istanza dell'oggetto Configuration e aggiungerlo alla raccolta Configurations. Questa proprietà è di sola lettura.
Description	Ottiene o imposta la descrizione della configurazione. Questa proprietà è di sola lettura.
ID	Restituisce l'ID assegnato alla configurazione. Questa proprietà è di sola lettura.
Name	Ottiene o imposta il nome dato a questa configurazione.
PackagePath	Ottiene o imposta il percorso del pacchetto al quale viene applicata la configurazione.

Metodi

Equals(Object)	Determina se due istanze di un oggetto sono uguali. (Ereditato da DtsObject)
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da DtsObject)
LoadFromXML(XmlNode, IDTSEvents)	Non è possibile chiamare questo metodo dal codice dell'applicazione. Per caricare un pacchetto salvato come file con estensione xml, utilizzare il metodo LoadPackage(String, IDTSEvents).
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	Non è possibile chiamare questo metodo dal codice dell'applicazione. Per salvare un pacchetto come file con estensione xml, utilizzare il metodo SaveToXml(String, Package, IDTSEvents).

Si applica a