XmlDataDocument.Load メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定したデータ ソースを使用して XmlDataDocument を読み込み、読み込まれたデータと DataSet を同期します。
オーバーロード
| 名前 | 説明 |
|---|---|
| Load(Stream) |
指定したストリームから |
| Load(TextReader) |
指定したTextReaderから |
| Load(String) |
指定した URL を使用して |
| Load(XmlReader) |
指定したXmlReaderから |
注釈
注
XML データをリレーショナルに表示するには、まず、データ マッピングに使用するスキーマを指定する必要があります。 これを行うには、 ReadXmlSchema メソッドを呼び出すか、 DataSet 内にテーブルと列を手動で作成します。 この手順は、 Loadを呼び出す前に実行する必要があります。
XmlDataDocument では、エンティティ参照の作成はサポートされていません。 データにエンティティ参照が含まれている場合、 Load メソッドはエンティティ参照を解決して展開します。 ただし、XmlReaderを引数として受け取るLoadオーバーロードを使用する場合は、エンティティを解決できるXmlReaderを指定する必要があります。
Load(Stream)
指定したストリームから XmlDataDocument を読み込みます。
public:
override void Load(System::IO::Stream ^ inStream);public override void Load(System.IO.Stream inStream);override this.Load : System.IO.Stream -> unitPublic Overrides Sub Load (inStream As Stream)パラメーター
- inStream
- Stream
読み込む XML ドキュメントを含むストリーム。
注釈
XmlDataDocument では、エンティティ参照の作成はサポートされていません。 データにエンティティ参照が含まれている場合、 Load メソッドはエンティティ参照を解決して展開します。
注
XML データをリレーショナルに表示するには、まず、データ マッピングに使用するスキーマを指定する必要があります。 これを行うには、 ReadXmlSchema メソッドを呼び出すか、 DataSet 内にテーブルと列を手動で作成します。 この手順は、 Loadを呼び出す前に実行する必要があります。
適用対象
Load(TextReader)
指定したTextReaderからXmlDataDocumentを読み込みます。
public:
override void Load(System::IO::TextReader ^ txtReader);public override void Load(System.IO.TextReader txtReader);override this.Load : System.IO.TextReader -> unitPublic Overrides Sub Load (txtReader As TextReader)パラメーター
- txtReader
- TextReader
TextReader XML データをドキュメントにフィードするために使用されます。
注釈
XmlDataDocument では、エンティティ参照の作成はサポートされていません。 データにエンティティ参照が含まれている場合、 Load メソッドはエンティティ参照を解決して展開します。
注
XML データをリレーショナルに表示するには、まず、データ マッピングに使用するスキーマを指定する必要があります。 これを行うには、 ReadXmlSchema メソッドを呼び出すか、 DataSet 内にテーブルと列を手動で作成します。 この手順は、 Loadを呼び出す前に実行する必要があります。
適用対象
Load(String)
指定した URL を使用して XmlDataDocument を読み込みます。
public:
override void Load(System::String ^ filename);public override void Load(string filename);override this.Load : string -> unitPublic Overrides Sub Load (filename As String)パラメーター
- filename
- String
読み込む XML ドキュメントを含むファイルの URL。
注釈
XmlDataDocument では、エンティティ参照の作成はサポートされていません。 データにエンティティ参照が含まれている場合、 Load メソッドはエンティティ参照を解決して展開します。
注
XML データをリレーショナルに表示するには、まず、データ マッピングに使用するスキーマを指定する必要があります。 これを行うには、 ReadXmlSchema メソッドを呼び出すか、 DataSet 内にテーブルと列を手動で作成します。 この手順は、 Loadを呼び出す前に実行する必要があります。
適用対象
Load(XmlReader)
指定したXmlReaderからXmlDataDocumentを読み込みます。
public:
override void Load(System::Xml::XmlReader ^ reader);public override void Load(System.Xml.XmlReader reader);override this.Load : System.Xml.XmlReader -> unitPublic Overrides Sub Load (reader As XmlReader)パラメーター
- reader
- XmlReader
読み込む XML ドキュメントを含む XmlReader 。
例外
読み込まれる XML にはエンティティ参照が含まれており、リーダーはエンティティを解決できません。
注釈
XmlDataDocument では、エンティティ参照の作成はサポートされていません。 データ ソースにエンティティ参照が含まれている場合は、EntityHandling プロパティが EntityHandling.ExpandEntities (既定の動作) に設定されたXmlValidatingReaderを作成し、XmlValidatingReaderを Load メソッドに渡す必要があります。
XmlValidatingReaderを使用しない場合、Load メソッドは例外をスローします。
Loadメソッドでは、常に重要な空白が保持されます。
PreserveWhitespace プロパティは、空白を保持するかどうかを決定します。 既定値は false、空白は保持されません。
リーダーが初期状態 (つまり、ReadState=ReadState.Initial) の場合、 Load はリーダーの内容全体を使用し、見つけたものから DOM をビルドします。
リーダーが既に深さ "n" のノードに配置されている場合、このメソッドは、そのノードとその後のすべての兄弟を、深さ "n" を閉じる終了タグまで読み込みます。 これには次の結果があります。
現在のノードとその次の兄弟が次のようになります。
<!--comment--><element1>one</element1><element2>two</element2>
Load は例外をスローします。ドキュメントにルート レベルの要素を 2 つ含めることはできません。 現在のノードとその次の兄弟が次のようになります。
<!--comment--><?process
instruction?><!--comment--></endtag>
Load は成功します。ただし、ルート レベルの要素がないため、不完全な DOM ツリーが作成されます。 ドキュメントを保存する前にルート レベルの要素を追加する必要があります。それ以外の場合、 Save メソッドは例外をスローします。
リーダーが、ドキュメントのルート レベル (空白や属性ノードなど) に対して無効なリーフ ノードに配置されている場合、リーダーはルートに使用できるノードに配置されるまで読み取りを続行します。 この時点でドキュメントの読み込みが開始されます。
