WmiEventWatcherTask.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要素を含むXMLドキュメントです。
- events
- IDTSInfoEvents
IDTSInfoEventsを実装するオブジェクト。
実装
注釈
この方法は、カスタムオブジェクトを作成する際に継承されるインターフェース上で公開されているため、 SaveToXML、SSISランタイムで出荷されるオブジェクトによって利用可能です。 このメソッドは継承のみを目的としており、他の目的でコードから呼び出すべきではありません。 カスタムオブジェクトを作成していて、自分で SaveToXML メソッドを書く方法について情報が必要な場合は、「 Extensionending Packages with Custom Objects(カスタムオブジェクト付きパッケージの拡張)」を参照してください。
パッケージを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と、その要素の値を生成するコードが含まれています。 パッケージにはXmlDocumentが含まれ、オブジェクトはそれぞれの要素をパッケージのXmlDocumentに付加します。 したがって、個々のオブジェクトの SaveToXML を直接呼び出すのではなく、 Application オブジェクトのメソッドを呼び出すと、ランタイムがパッケージオブジェクトをカスケードしてその SaveToXML を呼び出します。