XmlDocument.Load メソッド (TextReader)
指定した TextReader から XML ドキュメントを読み込みます。
Overloads Public Overridable Sub Load( _
ByVal txtReader As TextReader _)
[C#]
public virtual void Load(TextReadertxtReader);
[C++]
public: virtual void Load(TextReader* txtReader);
[JScript]
public function Load(
txtReader : TextReader);
パラメータ
- txtReader
XML データをドキュメントに送るために使用する TextReader 。
例外
例外の種類 | 条件 |
---|---|
XmlException | XML 内に読み込みエラーまたは解析エラーがあります。この場合、ドキュメントは空のままです。 |
解説
メモ Load メソッドは、有意な空白を常に保存します。 PreserveWhitespace プロパティは、空白が保存されるかどうかを決定します。既定値は false で、空白は保存されません。
このメソッドは、DTD 検証またはスキーマ検証を実行しません。検証を実行する場合は、 XmlValidatingReader を渡し、適切な XmlValidatingReader.ValidationType を指定し、 XmlValidatingReader.ValidationEventHandler を提供する必要があります。読み込み中に見つかったすべての検証エラーが通知されますが、 ValidationEventHandler が例外をスローして処理を中止する場合を除き、ドキュメントは読み込まれます。読み込み時検証の例については、「 XmlDocument 」を参照してください。
このメソッドは、ドキュメント オブジェクト モデル (DOM: Document Object Model) に対する Microsoft 拡張機能です。
使用例
[Visual Basic, C#, C++] StringReader クラスを使用して、XML データの文字列を XmlDocument オブジェクトに読み込む例を次に示します。
Imports System
Imports System.IO
Imports System.Xml
public class Sample
public shared sub Main()
' Create the XmlDocument.
Dim doc as XmlDocument = new XmlDocument()
Dim xmlData as string = "<book xmlns:bk='urn:samples'></book>"
doc.Load(new StringReader(xmlData))
' Create a new element and add it to the document.
Dim elem as XmlElement = doc.CreateElement("bk", "genre", "urn:samples")
elem.InnerText = "fantasy"
doc.DocumentElement.AppendChild(elem)
Console.WriteLine("Display the modified XML...")
doc.Save(Console.Out)
end sub
end class
[C#]
using System;
using System.IO;
using System.Xml;
public class Sample {
public static void Main() {
// Create the XmlDocument.
XmlDocument doc = new XmlDocument();
string xmlData = "<book xmlns:bk='urn:samples'></book>";
doc.Load(new StringReader(xmlData));
// Create a new element and add it to the document.
XmlElement elem = doc.CreateElement("bk", "genre", "urn:samples");
elem.InnerText = "fantasy";
doc.DocumentElement.AppendChild(elem);
Console.WriteLine("Display the modified XML...");
doc.Save(Console.Out);
}
}
[C++]
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
// Create the XmlDocument.
XmlDocument* doc = new XmlDocument();
String* xmlData = S"<book xmlns:bk='urn:samples'></book>";
doc->Load(new StringReader(xmlData));
// Create a new element and add it to the document.
XmlElement* elem = doc->CreateElement(S"bk", S"genre", S"urn:samples");
elem->InnerText = S"fantasy";
doc->DocumentElement->AppendChild(elem);
Console::WriteLine(S"Display the modified XML...");
doc->Save(Console::Out);
}
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET
参照
XmlDocument クラス | XmlDocument メンバ | System.Xml 名前空間 | XmlDocument.Load オーバーロードの一覧 | StreamReader | System.Xml.Schema.ValidationEventArgs | System.Xml.Schema.XmlSeverityType | XmlValidatingReader.Schemas