XML リーダーの作成

XmlReader インスタンスは、Create メソッドを使用して作成されます。XmlReaderSettings クラスは、XmlReader オブジェクトで有効にする機能のセットを指定するために使用されます。

各機能は、XmlReaderSettings クラスのプロパティを使用することによって、有効または無効にされます。その後、XmlReaderSettings オブジェクトは Create メソッドに渡されます。

Create メソッドと XmlReaderSettings クラスを使用すると、次の利点があります。

• 作成される XmlReader オブジェクトでサポートする機能を指定できます。

• 複数のリーダー オブジェクトの作成に、XmlReaderSettings クラスを再使用できます。同じ機能を持つ複数のリーダーの作成に、同じ設定を使用できます。もう 1 つの方法として、XmlReaderSettings インスタンスの設定を変更して、別の機能セットを持つ新しいリーダーを作成できます。

• 既存のリーダーに機能を追加できます。Create メソッドは別の XmlReader オブジェクトを受け取ることができます。基になる XmlReader オブジェクトは、ユーザー定義のリーダーまたは XmlTextReader オブジェクト、あるいは機能を追加する別の XmlReader インスタンスになることができます。

• .NET Framework 2.0 リリースで XmlReader クラスに追加されたすべての新機能を最大限に活用します。Create メソッドによって作成された XmlReader オブジェクトだけで利用可能な一致チェック機能の向上や XML 1.0 勧告との整合性の向上など、いくつかの機能があります。

次の表は、XmlReaderSettings クラスの既定のプロパティ設定の一覧です。

XmlReader のシナリオ

次の表は、いくつかの一般的なシナリオと XmlReaderSettings クラスに適用する設定を示しています。

Create メソッドによって作成されない XmlReader 実装の使用が必要になる可能性のある特別なシナリオがいくつかあります。

• XDR スキーマに対して検証する必要がある場合は、XmlValidatingReader クラスを使用します。

• XmlNode オブジェクトから XML データを読み取るには、XmlNodeReader クラスを使用します。

• 要求に応じてエンティティを展開する必要がある場合 (Create メソッドによって作成されたリーダーはすべてのエンティティを展開します)、またはテキスト コンテンツを正規化しない場合は、XmlTextReader クラスを使用します。

• 既定の属性を返さないようにする場合は、XmlTextReader クラスを使用します。

XmlReader オブジェクトをインスタンス化する方法

Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.IgnoreWhitespace = true
settings.IgnoreComments = true
Dim reader As XmlReader = XmlReader.Create("books.xml", settings)

XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.IgnoreWhitespace = true;
settings.IgnoreComments = true;
XmlReader reader = XmlReader.Create("books.xml", settings);

別のリーダー内にリーダー インスタンスをラップする方法

Dim txtReader As XmlTextReader = New XmlTextReader("bookOrder.xml")
Dim settings As New XmlReaderSettings()
settings.Schemas.Add("urn:po-schema", "PO.xsd")
settings.ValidationType = ValidationType.Schema
Dim reader As XmlReader = XmlReader.Create(txtReader, settings)

XmlTextReader txtReader = new XmlTextReader("bookOrder.xml");
XmlReaderSettings settings = new XmlReaderSettings();
settings.Schemas.Add("urn:po-schema", "PO.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader reader = XmlReader.Create(txtReader, settings);

リーダーをチェインして設定を追加する方法

Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.DTD
Dim inner As XmlReader = XmlReader.Create("book.xml", settings) ' DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd")
settings.ValidationType = ValidationType.Schema
Dim outer As XmlReader = XmlReader.Create(inner, settings)  ' XML Schema Validation

XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.DTD;
XmlReader inner = XmlReader.Create("book.xml", settings); // DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader outer = XmlReader.Create(inner, settings);  // XML Schema Validation

参照

概念

XmlReader による XML の読み取り