MessageQueueTask.SaveToXML(XmlDocument, IDTSInfoEvents) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
應用程式的程式碼不能呼叫這個方法。 若要將封裝另存為 .xml,請使用 SaveToXml(String, Package, IDTSEvents) 方法。
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)
參數
- doc
- XmlDocument
用於儲存資訊的 XML 文件。
- events
- IDTSInfoEvents
實作 IDTSInfoEvents 介面以便在持續性機制 (Persistence) 期間引發事件 (錯誤、警告等) 的物件。
實作
備註
這個方法 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,並為元素建立一個值。 封裝包含了內容,而且物件會將其特定元素附加至封裝的內容中。 因此,您不會直接 SaveToXML 在個別物件上呼叫,而是在物件上呼叫方法 Application ,而執行時間會透過封裝物件來重迭,並 SaveToXML 為您呼叫方法。