Configuration.SaveToXML(XmlDocument, XmlNode, IDTSEvents) Methode

Definition

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

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.

public:
 virtual void SaveToXML(System::Xml::XmlDocument ^ % doc, System::Xml::XmlNode ^ node, Microsoft::SqlServer::Dts::Runtime::IDTSEvents ^ events);

public void SaveToXML (ref System.Xml.XmlDocument doc, System.Xml.XmlNode node, Microsoft.SqlServer.Dts.Runtime.IDTSEvents events);

abstract member SaveToXML : XmlDocument * System.Xml.XmlNode * Microsoft.SqlServer.Dts.Runtime.IDTSEvents -> unit
override this.SaveToXML : XmlDocument * System.Xml.XmlNode * Microsoft.SqlServer.Dts.Runtime.IDTSEvents -> unit

Public Sub SaveToXML (ByRef doc As XmlDocument, node As XmlNode, events As IDTSEvents)

Parameter

doc

XmlDocument

Das XML-Dokument, in dem die Informationen gespeichert werden sollen.

node

XmlNode

Der Knoten, der das zu speichernde Objekt enthält.

events

IDTSEvents

Eine IDTSEvents-Schnittstelle.

Implementiert

SaveToXML(XmlDocument, XmlNode, IDTSEvents)

Hinweise

Diese Methode ist verfügbar, da sie auf einer Schnittstelle öffentlich ist, SaveToXML die Sie erben, wenn Sie benutzerdefinierte Objekte erstellen und von Objekten, die in der SSIS-Laufzeit gesendet wurden. Diese Methode ist nur für die Vererbung vorgesehen und sollte nicht aus Code für andere Zwecke aufgerufen werden. Wenn Sie ein benutzerdefiniertes Objekt erstellen und Informationen zum Schreiben Ihrer eigenen SaveToXML Methode benötigen, finden Sie unter Erweitern von Paketen mit benutzerdefinierten Objekten.

Wenn Sie ein Paket als XML speichern möchten, verwenden Sie die Microsoft.SqlServer.Dts.Runtime.Application.SaveToXml Methode. Wenn Sie das Paket im Dateisystem speichern möchten, verwenden Sie Microsoft.SqlServer.Dts.Runtime.Application.SaveToDtsServer. Wenn Sie das Paket in der MSDB-Datenbank speichern möchten, verwenden Microsoft.SqlServer.Dts.Runtime.Application.SaveToSqlServer Oder Microsoft.SqlServer.Dts.Runtime.Application.SaveToSqlServerAs Methoden. Wenn Sie die Microsoft.SqlServer.Dts.Runtime.Application.SaveToXml Methoden auf dem ApplicationAufruf der Methoden aufrufen, wird die Laufzeit durch die Aufgaben, Verbindungsmanager, Protokollanbieter und alle anderen Objekte, die vom Paket enthalten sind, durchlaufen und die SaveToXML Methode jeweils aufrufen. Die enthaltenen Objekte verfügen über Code in ihrer SaveToXML Eigenschaft, die ein XmlElement für jede Eigenschaft erstellt, die das Objekt speichern muss, und einen Wert für das Element. Das Paket enthält das XmlDocument und die Objekte fügen ihre spezifischen Elemente in das XmlDocument des Pakets an. Daher rufen Sie die SaveToXML einzelnen Objekte nicht direkt auf, rufen aber die Methode auf dem Application Objekt auf, und die Laufzeit wird über die Paketobjekte über die Paketobjekte kaskadieren und die SaveToXML für Sie aufrufen.