Configuration Klasse

Definition

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Stellt eine Konfigurationsklasse dar, die Informationen zur Konfiguration eines Pakets enthält. Diese Klasse kann nicht vererbt werden.

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

Vererbung

Object

DtsObject

Configuration

Implementiert

IDTSName IDTSPersist

Hinweise

Konfigurationen sind hilfreich beim Bereitstellen von Paketen auf viele verschiedene Server und machen es einfach, Pakete von der Entwicklung in Produktionsumgebungen zu verschieben.

Sie können Variablen verwenden, um Pakete dynamisch zu aktualisieren, wodurch Sie Paketfunktionen anpassen und Pakete an die Umgebungen anpassen können, in denen sie ausgeführt werden. Wenn Sie Paketeigenschaften zur Laufzeit mithilfe von Variablen aktualisieren möchten, ordnen Sie Variablen den Paketobjekteigenschaften zu, erstellen Sie Konfigurationen für die Variablen, stellen Sie die Konfigurationen mit dem Paket bereit, und aktualisieren Sie dann die Variablenwerte in der Konfigurationsdatei für die neue Umgebung. Zum Laufzeitzeitpunkt verwendet das Paket automatisch die aktualisierten Werte. Diese Flexibilität ist nützlich, wenn die Von Ihnen bereitgestellten Pakete eine Verbindung mit verschiedenen Servern bereitgestellt haben, unterschiedliche SQL-Anweisungen ausführen oder unterschiedliche untergeordnete Pakete ausführen. Weitere Informationen finden Sie unter Erstellen von Paketkonfigurationen und Verwenden von Variablen in Paketen.

Eigenschaften

ConfigurationString	Ruft den Speicherort der Konfiguration ab oder legt ihn fest.
ConfigurationType	Ruft einen Wert von DTSConfigurationType ab, der beschreibt, in welcher Art Datei die Konfigurationsinformationen gespeichert sind, oder legt ihn fest.
CreationName	Gibt die Zeichenfolge zurück, die von der Runtime-Engine zum Erstellen einer Instanz des Configuration-Objekts und zum Hinzufügen des Objekts zur Configurations-Auflistung verwendet wird. Diese Eigenschaft ist schreibgeschützt.
Description	Ruft die Beschreibung der Konfiguration ab oder legt sie fest. Diese Eigenschaft ist schreibgeschützt.
ID	Gibt die der Konfiguration zugewiesene ID zurück. Diese Eigenschaft ist schreibgeschützt.
Name	Ruft den dieser Konfiguration zugewiesenen Namen ab oder legt ihn fest.
PackagePath	Ruft den Pfad des Pakets ab, für das die Konfiguration gilt, oder legt ihn fest.

Methoden

Equals(Object)	Stellt fest, ob zwei Objektinstanzen gleich sind. (Geerbt von DtsObject)
GetHashCode()	Gibt den Hashcode für diese Instanz zurück. (Geerbt von DtsObject)
LoadFromXML(XmlNode, IDTSEvents)	Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein im XML-Format gespeichertes Paket zu laden, verwenden Sie die LoadPackage(String, IDTSEvents)-Methode.
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	Diese Methode kann durch den Anwendungscode nicht aufgerufen werden. Um ein Paket als XML-Datei zu speichern, verwenden Sie die SaveToXml(String, Package, IDTSEvents)-Methode.