ConnectionManager.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 -> unitPublic Sub SaveToXML (ByRef doc As XmlDocument, node As XmlNode, events As IDTSEvents)パラメーター
- doc
- XmlDocument
接続マネージャー情報の保存先の XML ドキュメントです。
- node
- XmlNode
情報の保存先となる上記の XML ドキュメント内のノードです。
- 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 メソッドを呼び出します。 格納されるオブジェクトは、オブジェクトが保存する必要がある各プロパティの XmlElement を作成するコードを SaveToXML に含むほか、要素の値を含みます。 パッケージには XmlDocument が含まれており、各オブジェクトはそのオブジェクト固有の要素をパッケージの XmlDocument に追加します。 したがって、個々のオブジェクトで SaveToXML を直接呼び出すのではなく、Application オブジェクトでこのメソッドを呼び出します。これにより、ランタイムによってパッケージ オブジェクトが連鎖的に処理され、SaveToXML が呼び出されます。