ExecuteSQLTask.SaveToXML(XmlDocument, IDTSInfoEvents) Methode

Definition

Namespace:

Microsoft.SqlServer.Dts.Tasks.ExecuteSQLTask

Assembly:

Microsoft.SqlServer.SQLTask.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, Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events);

public void SaveToXML (System.Xml.XmlDocument doc, Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events);

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

Public Sub SaveToXML (doc As XmlDocument, events As IDTSInfoEvents)

Parameter

doc

XmlDocument

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

events

IDTSInfoEvents

Ein Objekt, das die IDTSInfoEvents-Schnittstelle zum Auslösen von Ereignissen (Fehlern, Warnungen usw.) während der Persistenz implementiert.

Implementiert

SaveToXML(XmlDocument, IDTSInfoEvents)

Hinweise

Diese Methode ist verfügbar, da sie auf einer Schnittstelle öffentlich ist, SaveToXMLdie Sie erben, wenn Sie benutzerdefinierte Objekte erstellen und von Objekten, die in der SSIS-Laufzeit gesendet wurden, bereitgestellt werden. 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.