TransferDatabaseTask.LoadFromXML(XmlElement, IDTSInfoEvents) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
このメソッドはアプリケーションコードでは呼び出せません。 .xmlとして保存されたパッケージを読み込むには、 LoadPackage(String, IDTSEvents) メソッドを使います。
public:
virtual void LoadFromXML(System::Xml::XmlElement ^ rootNode, Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events);
public void LoadFromXML(System.Xml.XmlElement rootNode, Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events);
abstract member LoadFromXML : System.Xml.XmlElement * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> unit
override this.LoadFromXML : System.Xml.XmlElement * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> unit
Public Sub LoadFromXML (rootNode As XmlElement, events As IDTSInfoEvents)
パラメーター
- rootNode
- XmlElement
読み込む情報を含むXmlElementです。
- events
- IDTSInfoEvents
永続化中にイベント(エラー、警告など)を発生させるための IDTSInfoEvents インターフェースを実装するオブジェクトです。
実装
注釈
この方法は、カスタムオブジェクトを作成する際に継承されるインターフェース上で公開されているため、 LoadFromXML、SSISランタイムで出荷されるオブジェクトによって利用可能です。 このメソッドは継承のみを目的としており、他の目的でコードから呼び出すべきではありません。 カスタムオブジェクトを作成していて、自分で LoadFromXML メソッドを書く方法について情報が必要な場合は、「 Extensionending Packages with Custom Objects(カスタムオブジェクト付きパッケージの拡張)」を参照してください。
XMLとして保存されたパッケージを読み込みたい場合は、 Microsoft.SqlServer.Dts.Runtime.Application.LoadPackage メソッドを使ってください。 パッケージがファイルシステムやMSDBデータベースに保存されている場合は、 Microsoft.SqlServer.Dts.Runtime.Application.LoadFromSqlServer または Microsoft.SqlServer.Dts.Runtime.Application.LoadFromDtsServer メソッドを使用します。
Application上のロードメソッドを呼び出すと、ランタイムはパッケージに含まれるタスク、接続マネージャー、ログプロバイダー、その他すべてのオブジェクトを順次処理し、それぞれのLoadFromXMLメソッドを呼び出します。 含まれるオブジェクトのコードは、オブジェクトが再作成しなければならない各プロパティのXmlElementと、その要素のために保存された値を解析するコード LoadFromXML に含まれています。 したがって、個々のオブジェクトの LoadFromXML を直接呼び出すのではなく、 Application オブジェクトのメソッドを呼び出すと、ランタイムがパッケージ全体にカスケードされ、オブジェクトの LoadFromXML を呼び出します。