DTSProcessingTask.SaveToXML(XmlDocument, IDTSInfoEvents) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
パッケージ XML にコンポーネント情報を保存します。 このメソッドをアプリケーション コードから呼び出すことはできません。 パッケージを .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 -> unitPublic Sub SaveToXML (doc As XmlDocument, events As IDTSInfoEvents)パラメーター
- doc
- XmlDocument
情報の保存先の XML ドキュメントです。
- events
- IDTSInfoEvents
保存中にイベント (エラー、警告など) を発生させるための IDTSInfoEvents インターフェイスを実装するオブジェクトです。
実装
注釈
このメソッド は、 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 が呼び出されます。