ConnectionManager.SaveToXML(XmlDocument, XmlNode, IDTSEvents) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitPublic Sub SaveToXML (ByRef doc As XmlDocument, node As XmlNode, events As IDTSEvents)Parameter
- doc
- XmlDocument
Das XML-Dokument, in dem die Informationen zum Verbindungs-Manager gespeichert werden sollen.
- node
- XmlNode
Der Knoten innerhalb des oben erwähnten Dokuments, in dem die Informationen gespeichert werden sollen.
- events
- IDTSEvents
Ein Objekt, das die IDTSEvents-Schnittstelle zum Auslösen von Ereignissen (Fehlern, Warnungen usw.) während der Persistenz implementiert.
Implementiert
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.