XmlTextReader クラス
XML データへの高速で非キャッシュの前方向アクセスを提供するリーダーを表します。
この型のすべてのメンバの一覧については、XmlTextReader メンバ を参照してください。
System.Object
System.Xml.XmlReader
System.Xml.XmlTextReader
Public Class XmlTextReader
Inherits XmlReader
Implements IXmlLineInfo
[C#]
public class XmlTextReader : XmlReader, IXmlLineInfo
[C++]
public __gc class XmlTextReader : public XmlReader, IXmlLineInfo
[JScript]
public class XmlTextReader extends XmlReader implements
IXmlLineInfo
スレッドセーフ
この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。
解説
XmlTextReader は、XML データのストリームへの前方向の読み取り専用アクセスを提供します。現在のノードは、リーダーが配置されているノードを参照します。リーダーは読み取りメソッドを使用して進み、プロパティには現在のノードの値が反映されます。
このクラスは XmlReader を実装し、W3C 勧告『Extensible Markup Language (XML) 1.0』および勧告『Namespaces in XML』に準拠しています。 XmlTextReader は、次の機能を提供します。
- 整形式の XML の規則を適用します。
- XmlTextReader は、データ検証を提供しません。
- DocumentType ノードが整形式かどうかを確認します。 XmlTextReader は、DTD が整形式かどうかを確認しますが、DTD を使用した検証は行いません。
- NodeType が XmlNodeType.EntityReference であるノードの場合は、単一の空の EntityReference ノードが返されます。つまり、 Value プロパティは String.Empty です。 メモ : DTD 内のエンティティの実際の宣言は、 Entity ノードと呼ばれます。これらのノードをデータで参照するときは、 EntityReference ノードと呼ばれます。
- 既定の属性を展開しません。
XmlTextReader は、データ検証に必要な補足チェックを実行しないため、高速の整形式パーサーを提供します。
データ検証を実行するには、 XmlValidatingReader を使用します。
XmlDocument から XML データを読み取るには、 XmlNodeReader を使用します。
厳密に型指定されたデータを読み取るには、 XmlConvert クラスを使用します。たとえば、次に示す C# コードはデータを読み取り、String から Double に変換します。
Double price = XmlConvert.ToDouble(reader.Value);
XmlTextReader は、XML 解析エラー時に XmlException をスローします。例外がスローされると、リーダーの状態は予測不可能になります。たとえば、報告されたノード型が、現在のノードの実際のノード型と異なる場合があります。
継承時の注意: このクラスには継承確認要求があります。 XmlTextReader から継承するには、完全信頼が必要です。詳細については、「 継承確認要求 」を参照してください。
XmlReader クラスの詳細については、「 XmlReader による XML の読み取り 」を参照してください。
必要条件
名前空間: System.Xml
プラットフォーム: 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
アセンブリ: System.Xml (System.Xml.dll 内)