Configuration Klasse

Definition

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
Configuration
Implementiert

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.

Gilt für: