Configuration.SaveToXML(XmlDocument, XmlNode, IDTSEvents) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
應用程式的程式碼不能呼叫這個方法。 若要將封裝另存為 .xml,請使用 SaveToXml(String, Package, IDTSEvents) 方法。
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)
參數
- doc
- XmlDocument
用於儲存資訊的 XML 文件。
- node
- XmlNode
包含要儲存之物件的節點。
- events
- IDTSEvents
IDTSEvents 介面。
實作
備註
這個方法 SaveToXML 可供使用,因為它在您建立自訂物件時所繼承的介面,以及 SSIS 執行時間隨附的物件中是公用的。 這個方法僅適用于繼承,不應從程式碼呼叫以供其他用途。 如果您要建立自訂物件,而且需要如何撰寫您自己的方法的相關資訊 SaveToXML ,請參閱使用自訂物件擴充封裝。
如果您想要將封裝儲存為 XML,請使用 Microsoft.SqlServer.Dts.Runtime.Application.SaveToXml 方法。 如果您想要將封裝儲存至檔案系統,請使用 Microsoft.SqlServer.Dts.Runtime.Application.SaveToDtsServer 。 如果您想要將封裝儲存到 MSDB 資料庫,請使用 Microsoft.SqlServer.Dts.Runtime.Application.SaveToSqlServer 或 Microsoft.SqlServer.Dts.Runtime.Application.SaveToSqlServerAs 方法。 當您 Microsoft.SqlServer.Dts.Runtime.Application.SaveToXml 在上呼叫方法時 Application ,執行時間會逐一查看工作、連接管理員、記錄提供者,以及封裝所包含的所有其他物件,並 SaveToXML 在每一個上呼叫方法。 包含的物件在其中具有 SaveToXML 程式碼,其會為物件必須儲存的每個屬性建立 XmlElement,並針對元素的值建立 XmlElement。 封裝包含 [Xml],而物件會將其特定元素附加至封裝的 [Xml]。 因此,您不會直接呼叫 SaveToXML 個別物件上的,而是在物件上呼叫方法 Application ,而執行時間會透過封裝物件進行 cascade,並 SaveToXML 為您呼叫。