XmlTextReaderとは? わかりやすく解説

XmlTextReader クラス

XML データへの高速で非キャッシュの前方向アクセスを提供するリーダーを表します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

Public Class XmlTextReader
    Inherits XmlReader
    Implements IXmlLineInfo, IXmlNamespaceResolver
Dim instance As XmlTextReader
public class XmlTextReader : XmlReader, IXmlLineInfo,
 IXmlNamespaceResolver
public ref class XmlTextReader : public
 XmlReader, IXmlLineInfo, IXmlNamespaceResolver
public class XmlTextReader extends XmlReader
 implements IXmlLineInfo, IXmlNamespaceResolver
public class XmlTextReader extends
 XmlReader implements IXmlLineInfo, IXmlNamespaceResolver
解説解説

XmlTextReader は、XML データのストリームへの前方向の読み取り専用アクセスを提供します。現在のノードは、リーダーが配置されているノードを参照します。リーダーは読み取りメソッドを使用して進み、プロパティには現在のノードの値が反映されます。

このクラスは XmlReader を実装し、W3C 勧告『Extensible Markup Language (XML) 1.0』および勧告『Namespaces in XML』に準拠しています。XmlTextReader は、次の機能を提供します。

メモメモ

DTD 内のエンティティの実際の宣言は、Entity ノードと呼ばれます。これらのノードをデータで参照するときは、EntityReference ノードと呼ばれます。

XmlTextReader は、データ検証に必要な補足チェックを実行しないため、高速の整形式パーサーを提供します。

データ検証を実行するには、検証 XmlReader を使用します。詳細については、「XmlReader による XML データの検証」を参照してください。

XmlDocument から XML データを読み取るには、XmlNodeReader を使用します。

XmlTextReader は、XML 解析エラー時に XmlException をスローします。例外がスローされると、リーダーの状態は予測不可能になります。たとえば、報告されたノード型が、現在のノードの実際のノード型と異なる場合があります。リーダーがエラー状態にあるかどうかを確認するには、ReadState プロパティを使用します。

XmlReader クラスの詳細については、「XmlReader による XML の読み取り」を参照してください。

セキュリティについての考慮事項

XmlTextReader クラスを使用する際の考慮事項を次に示します。

継承時の注意 このクラスには継承確認要求があります。XmlTextReader から継承するには、完全信頼が必要です。詳細については、「継承確認要求」を参照してください。

継承階層継承階層
System.Object
   System.Xml.XmlReader
    System.Xml.XmlTextReader
スレッド セーフスレッド セーフ
この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader コンストラクタ ()


XmlTextReader コンストラクタ (TextReader)

TextReader を指定して、XmlTextReader クラスの新しいインスタンスを初期化します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

Public Sub New ( _
    input As TextReader _
)
Dim input As TextReader

Dim instance As New XmlTextReader(input)
public XmlTextReader (
    TextReader input
)
public:
XmlTextReader (
    TextReader^ input
)
public XmlTextReader (
    TextReader input
)
public function XmlTextReader (
    input : TextReader
)

パラメータ

input

読み取る XML データを格納している TextReader。

解説解説
使用例使用例

StringReader クラスを使用して、XmlTextReader オブジェクトに XML 文字列を読み込む例を次に示します。

Imports System
Imports System.IO
Imports System.Xml

public class Sample 

  public shared sub Main()

    Dim xmlData as string
 
    xmlData = "<book>" & _
              "  <title>Oberon's Legacy</title>"
 & _
              "  <price>5.95</price>"
 & _
              "</book>"

    ' Create the reader.
    Dim reader as XmlTextReader = new
 XmlTextReader(new StringReader(xmlData))
    reader.WhitespaceHandling = WhitespaceHandling.None

    ' Display each element node.
    while reader.Read()
       select case reader.NodeType
         case XmlNodeType.Element
           Console.Write("<{0}>", reader.Name)
         case XmlNodeType.Text
           Console.Write(reader.Value)
         case XmlNodeType.EndElement
           Console.Write("</{0}>", reader.Name)
       end select       
    end while           

    ' Close the reader.
    reader.Close()       
  end sub
end class
using System;
using System.IO;
using System.Xml;

public class Sample {

  public static void Main()
 {

    string xmlData = 
    @"<book>
       <title>Oberon's Legacy</title>
       <price>5.95</price>
      </book>";

    // Create the reader.
    XmlTextReader reader = new XmlTextReader(new
 StringReader(xmlData));
    reader.WhitespaceHandling = WhitespaceHandling.None;

    // Display each element node.
    while (reader.Read()){
       switch (reader.NodeType){
         case XmlNodeType.Element:
           Console.Write("<{0}>", reader.Name);
           break;
         case XmlNodeType.Text:
           Console.Write(reader.Value);
           break;
         case XmlNodeType.EndElement:
           Console.Write("</{0}>", reader.Name);
           break;
      }       
    }           

    // Close the reader.
    reader.Close();       
  }
} // End class
#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   String^ xmlData = "<book>\r\n       <title>Oberon's Legacy</title>\r\n
       <price>5.95</price>\r\n      </book>";
   
   // Create the reader.
   XmlTextReader^ reader = gcnew XmlTextReader( gcnew StringReader( xmlData ) );
   reader->WhitespaceHandling = WhitespaceHandling::None;
   
   // Display each element node.
   while ( reader->Read() )
   {
      switch ( reader->NodeType )
      {
         case XmlNodeType::Element:
            Console::Write( "<{0}>", reader->Name );
            break;

         case XmlNodeType::Text:
            Console::Write( reader->Value );
            break;

         case XmlNodeType::EndElement:
            Console::Write( "</{0}>", reader->Name );
            break;
      }
   }

   
   // Close the reader.
   reader->Close();
}

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[]
 args)
    {
        String xmlData = "<book>\n" + "       <title>Oberon's
 Legacy</title>\n" 
            + "       <price>5.95</price>\n" + "     
 </book>";
        // Create the reader.
        XmlTextReader reader = new XmlTextReader(new
 StringReader(xmlData));
        reader.set_WhitespaceHandling(WhitespaceHandling.None);
        // Display each element node.
        while (reader.Read()) {
            switch (reader.get_NodeType()) {
                case XmlNodeType.Element:
                    Console.Write("<{0}>", reader.get_Name());
                    break;

                case XmlNodeType.Text:
                    Console.Write(reader.get_Value());
                    break;

                case XmlNodeType.EndElement:
                    Console.Write("</{0}>", reader.get_Name());
                    break;
            }
        }
        // Close the reader.
        reader.Close();
    } //main
} //End class Sample
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader コンストラクタ (String, XmlNameTable)

指定したファイルと XmlNameTable を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

Public Sub New ( _
    url As String, _
    nt As XmlNameTable _
)
Dim url As String
Dim nt As XmlNameTable

Dim instance As New XmlTextReader(url,
 nt)
public XmlTextReader (
    string url,
    XmlNameTable nt
)
public:
XmlTextReader (
    String^ url, 
    XmlNameTable^ nt
)
public XmlTextReader (
    String url, 
    XmlNameTable nt
)
public function XmlTextReader (
    url : String, 
    nt : XmlNameTable
)

パラメータ

url

読み取る XML データを格納しているファイルの URL。

nt

使用する XmlNameTable。

例外例外
例外の種類条件

NullReferenceException

nt 値が null 参照 (Visual Basic では Nothing) です。

FileNotFoundException

指定されたファイルが見つかりません。

DirectoryNotFoundException

ファイル名またはディレクトリの一部が見つかりません。

InvalidOperationException

url が空の文字列です。

WebException

リモート ファイル名を解決できません。

または

要求の処理中にエラーが発生しました。

UriFormatException

url が有効な URI ではありません。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader コンストラクタ (Stream, XmlNodeType, XmlParserContext)

指定したストリーム、XmlNodeType、および XmlParserContext を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

Public Sub New ( _
    xmlFragment As Stream, _
    fragType As XmlNodeType, _
    context As XmlParserContext _
)
Dim xmlFragment As Stream
Dim fragType As XmlNodeType
Dim context As XmlParserContext

Dim instance As New XmlTextReader(xmlFragment,
 fragType, context)
public XmlTextReader (
    Stream xmlFragment,
    XmlNodeType fragType,
    XmlParserContext context
)
public:
XmlTextReader (
    Stream^ xmlFragment, 
    XmlNodeType fragType, 
    XmlParserContext^ context
)
public XmlTextReader (
    Stream xmlFragment, 
    XmlNodeType fragType, 
    XmlParserContext context
)
public function XmlTextReader (
    xmlFragment : Stream, 
    fragType : XmlNodeType, 
    context : XmlParserContext
)

パラメータ

xmlFragment

解析する XML フラグメントを含んでいるストリーム。

fragType

XML フラグメントの XmlNodeType。これもフラグメントに何を含めることができるかを判断します。下の表を参照してください。

context

xmlFragment の解析先の XmlParserContext。これには、使用する XmlNameTable、エンコーディング、名前空間スコープ、現在の xml:lang、および xml:space スコープが含まれます。

例外例外
例外の種類条件

XmlException

fragType が Element、Attribute、または Document のいずれかの XmlNodeType ではありません。

ArgumentNullException

xmlFragment が null 参照 (Visual Basic では Nothing) です。

解説解説

このコンストラクタは、指定した文字列を XML のフラグメントとして解析します。XML フラグメントが要素または属性の場合は、整形式 XML ドキュメントのルート レベルの規則をバイパスできます。

fragType の有効な値の一覧を次の表に示します。

リーダーは、次を使用してストリームのエンコーディングを判断します。

  1. XmlParserContext.Encoding プロパティをチェックして、エンコーディングを判断します。

  2. Encoding プロパティが null 参照 (Visual Basic では Nothing) の場合、リーダーは、ストリームの先頭でバイト順のマークを確認します。

  3. Encoding プロパティが null 参照 (Visual Basic では Nothing) で、バイト順のマークが見つからない場合は、リーダーは、ストリームが UTF-8 でエンコードされることを前提とします。

プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader コンストラクタ (String, Stream, XmlNameTable)

指定した URL、ストリーム、および XmlNameTable を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

Public Sub New ( _
    url As String, _
    input As Stream, _
    nt As XmlNameTable _
)
Dim url As String
Dim input As Stream
Dim nt As XmlNameTable

Dim instance As New XmlTextReader(url,
 input, nt)
public XmlTextReader (
    string url,
    Stream input,
    XmlNameTable nt
)
public:
XmlTextReader (
    String^ url, 
    Stream^ input, 
    XmlNameTable^ nt
)
public XmlTextReader (
    String url, 
    Stream input, 
    XmlNameTable nt
)
public function XmlTextReader (
    url : String, 
    input : Stream, 
    nt : XmlNameTable
)

パラメータ

url

外部リソースを解決するために使用する URL。BaseURI は、この値に設定されます。url が null 参照 (Visual Basic では Nothing) の場合は、BaseURI が String.Empty に設定されます。

input

読み取る XML データを格納しているストリーム。

nt

使用する XmlNameTable。

例外例外
例外の種類条件

NullReferenceException

input または nt の値が null 参照 (Visual Basic では Nothing) です。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader コンストラクタ

XmlTextReader の新しいインスタンスを初期化します。


オーバーロードの一覧オーバーロードの一覧
名前 説明
XmlTextReader () XmlTextReader の新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

XmlTextReader (Stream) 指定したストリームを使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

XmlTextReader (String) 指定したファイルを使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

XmlTextReader (TextReader) TextReader を指定して、XmlTextReader クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

XmlTextReader (XmlNameTable) XmlNameTable を指定して、XmlTextReader クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

XmlTextReader (Stream, XmlNameTable) 指定したストリームと XmlNameTable を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

XmlTextReader (String, Stream) 指定した URL とストリームを使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

XmlTextReader (String, TextReader) 指定した URL と TextReader を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

XmlTextReader (String, XmlNameTable) 指定したファイルと XmlNameTable を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

XmlTextReader (TextReader, XmlNameTable) 指定した TextReader と XmlNameTable を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

XmlTextReader (Stream, XmlNodeType, XmlParserContext) 指定したストリーム、XmlNodeType、および XmlParserContext を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

XmlTextReader (String, Stream, XmlNameTable) 指定した URL、ストリーム、および XmlNameTable を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

XmlTextReader (String, TextReader, XmlNameTable) 指定した URL、TextReader、および XmlNameTable を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

XmlTextReader (String, XmlNodeType, XmlParserContext) 指定した文字列、XmlNodeType、および XmlParserContext を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

.NET Compact Framework によってサポートされています。

参照参照

関連項目

XmlTextReader クラス
XmlTextReader メンバ
System.Xml 名前空間

その他の技術情報

XmlReader による XML の読み取り

XmlTextReader コンストラクタ (XmlNameTable)

XmlNameTable を指定して、XmlTextReader クラスの新しいインスタンスを初期化します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

Protected Sub New ( _
    nt As XmlNameTable _
)
Dim nt As XmlNameTable

Dim instance As New XmlTextReader(nt)
protected XmlTextReader (
    XmlNameTable nt
)
protected:
XmlTextReader (
    XmlNameTable^ nt
)
protected XmlTextReader (
    XmlNameTable nt
)
protected function XmlTextReader (
    nt : XmlNameTable
)

パラメータ

nt

使用する XmlNameTable。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader コンストラクタ (String, Stream)

指定した URL とストリームを使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

例外例外
例外の種類条件

ArgumentNullException

input が null 参照 (Visual Basic では Nothing) です。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader コンストラクタ (String)

指定したファイルを使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

public XmlTextReader (
    string url
)
public:
XmlTextReader (
    String^ url
)
public XmlTextReader (
    String url
)
public function XmlTextReader (
    url : String
)

パラメータ

url

XML データを格納しているファイルの URL。BaseURI は、この値に設定されます。

例外例外
例外の種類条件

FileNotFoundException

指定されたファイルが見つかりません。

DirectoryNotFoundException

ファイル名またはディレクトリの一部が見つかりません。

InvalidOperationException

url が空の文字列です。

WebException

リモート ファイル名を解決できません。

または

要求の処理中にエラーが発生しました。

UriFormatException

url が有効な URI ではありません。

解説解説

アクセスの資格情報が必要なリソースにファイルがある場合は、XmlResolver プロパティを使用して必要な資格情報を指定します。

メモメモ

.NET Framework Version 1.1 では、信頼性が一部しか確認されていないコードでは XmlResolver プロパティを設定できません。代替手段として、必要な資格情報で XmlUrlResolver を作成し、XmlUrlResolver.GetEntity メソッドに URI を渡して、結果として得られた Stream オブジェクトを使用して XmlTextReader を構築します。これは、次の C# コードで記述します。

 // Create a resolver with the necessary credentials.
 XmlUrlResolver resolver = new XmlUrlResolver();
 NetworkCredential nc = new NetworkCredential(SecurelyStoredUserName, SecurelyStoredPassword,
 SecurelyStoredDomain);
 resolver.Credentials = nc; 
 // Get a Stream object containing the XML file.
 Uri myUri = new Uri ("http://myServer/data/books.xml");
 Stream s=(Stream)resolver.GetEntity(myUri, null, typeof(Stream));
 // Construct a reader using the Stream object.
 XmlTextReader reader = new XmlTextReader(s);
使用例使用例

XML を読み込み、各ノードを表示する例を次に示します。

Option Strict
Option Explicit

Imports System
Imports System.IO
Imports System.Xml

'Reads an XML document
Public Class Sample
    Private Const filename As
 String = "items.xml"
    
    Public Shared Sub Main()
        Dim reader As XmlTextReader = Nothing
        
        Try
            ' Load the reader with the data file and ignore all white
 space nodes.         
            reader = New XmlTextReader(filename)
            reader.WhitespaceHandling = WhitespaceHandling.None
            
            ' Parse the file and display each of the nodes.
            While reader.Read()
                Select Case reader.NodeType
                    Case XmlNodeType.Element
                        Console.Write("<{0}>",
 reader.Name)
                    Case XmlNodeType.Text
                        Console.Write(reader.Value)
                    Case XmlNodeType.CDATA
                        Console.Write("<![CDATA[{0}]]>",
 reader.Value)
                    Case XmlNodeType.ProcessingInstruction
                        Console.Write("<?{0} {1}?>",
 reader.Name, reader.Value)
                    Case XmlNodeType.Comment
                        Console.Write("<!--{0}-->",
 reader.Value)
                    Case XmlNodeType.XmlDeclaration
                        Console.Write("<?xml version='1.0'?>")
                    Case XmlNodeType.Document
                    Case XmlNodeType.DocumentType
                        Console.Write("<!DOCTYPE {0} [{1}]",
 reader.Name, reader.Value)
                    Case XmlNodeType.EntityReference
                        Console.Write(reader.Name)
                    Case XmlNodeType.EndElement
                        Console.Write("</{0}>",
 reader.Name)
                End Select
            End While
        
        Finally
            If Not (reader Is
 Nothing) Then
                reader.Close()
            End If
        End Try
    End Sub 'Main 
End Class 'Sample
using System;
using System.IO;
using System.Xml;

public class Sample {

  private const String filename = "items.xml";

  public static void Main()
 {
  
     XmlTextReader reader = null;

     try {
       
        // Load the reader with the data file and ignore all white space
 nodes.         
        reader = new XmlTextReader(filename);
        reader.WhitespaceHandling = WhitespaceHandling.None;

        // Parse the file and display each of the nodes.
        while (reader.Read()) {
           switch (reader.NodeType) {
             case XmlNodeType.Element:
               Console.Write("<{0}>", reader.Name);
               break;
             case XmlNodeType.Text:
               Console.Write(reader.Value);
               break;
             case XmlNodeType.CDATA:
               Console.Write("<![CDATA[{0}]]>", reader.Value);
               break;
             case XmlNodeType.ProcessingInstruction:
               Console.Write("<?{0} {1}?>", reader.Name, reader.Value);
               break;
             case XmlNodeType.Comment:
               Console.Write("<!--{0}-->", reader.Value);
               break;
             case XmlNodeType.XmlDeclaration:
               Console.Write("<?xml version='1.0'?>");
               break;
             case XmlNodeType.Document:
               break;
             case XmlNodeType.DocumentType:
               Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value);
               break;
             case XmlNodeType.EntityReference:
               Console.Write(reader.Name);
               break;
             case XmlNodeType.EndElement:
               Console.Write("</{0}>", reader.Name);
               break;
           }       
        }           
     }

     finally {
        if (reader!=null)
          reader.Close();
     }
  }
} // End class
#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlTextReader^ reader = nullptr;
   String^ filename = "items.xml";
   try
   {
      
      // Load the reader with the data file and ignore all white space
 nodes.         
      reader = gcnew XmlTextReader( filename );
      reader->WhitespaceHandling = WhitespaceHandling::None;
      
      // Parse the file and display each of the nodes.
      while ( reader->Read() )
      {
         switch ( reader->NodeType )
         {
            case XmlNodeType::Element:
               Console::Write( "<{0}>", reader->Name );
               break;

            case XmlNodeType::Text:
               Console::Write( reader->Value );
               break;

            case XmlNodeType::CDATA:
               Console::Write( "<![CDATA[{0}]]>", reader->Value
 );
               break;

            case XmlNodeType::ProcessingInstruction:
               Console::Write( "<?{0} {1}?>", reader->Name, reader->Value
 );
               break;

            case XmlNodeType::Comment:
               Console::Write( "<!--{0}-->", reader->Value );
               break;

            case XmlNodeType::XmlDeclaration:
               Console::Write( "<?xml version='1.0'?>" );
               break;

            case XmlNodeType::Document:
               break;

            case XmlNodeType::DocumentType:
               Console::Write( "<!DOCTYPE {0} [{1}]", reader->Name,
 reader->Value );
               break;

            case XmlNodeType::EntityReference:
               Console::Write( reader->Name );
               break;

            case XmlNodeType::EndElement:
               Console::Write( "</{0}>", reader->Name );
               break;
         }
      }
   }
   finally
   {
      if ( reader != nullptr )
            reader->Close();
   }

}

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    private static String fileName = "items.xml";

    public static void main(String[]
 args)
    {
        XmlTextReader reader = null;
        try {

            // Load the reader with the data file and ignore 
            //all white space nodes.         
            reader = new XmlTextReader(fileName);
            reader.set_WhitespaceHandling(WhitespaceHandling.None);

            // Parse the file and display each of the nodes.
            while(reader.Read()) {
                switch(reader.get_NodeType() ) {
                    case XmlNodeType.Element : 
                        Console.Write("<{0}>", reader.get_Name());
                        break;
                    case XmlNodeType.Text : 
                        Console.Write(reader.get_Value());
                        break;
                    case XmlNodeType.CDATA : 
                        Console.Write("<![CDATA[{0}]]>", reader.get_Value());
                        break;
                    case XmlNodeType.ProcessingInstruction : 
                        Console.Write("<?{0} {1}?>", reader.get_Name()
,
                        reader.get_Value());
                        break;
                    case XmlNodeType.Comment : 
                        Console.Write("<!--{0}-->", reader.get_Value());
                        break;
                    case XmlNodeType.XmlDeclaration : 
                        Console.Write("<?xml version='1.0'?>");
                        break;
                    case XmlNodeType.Document : 
                        break;
                    case XmlNodeType.DocumentType : 
                        Console.Write("<!DOCTYPE {0} [{1}]", reader.get_Name()
,
                        reader.get_Value());
                        break;
                    case XmlNodeType.EntityReference : 
                        Console.Write(reader.get_Name());
                        break;
                    case XmlNodeType.EndElement : 
                        Console.Write("</{0}>", reader.get_Name());
                        break;
                }
            }
        }
        finally {
            if (reader != null) {
                reader.Close();
            }
        }
    } //main
} // End class Sample

この例では、入力として、items.xml というファイルを使用しています。

<?xml version="1.0"?>
<!-- This is a sample XML document -->
<!DOCTYPE Items [<!ENTITY
 number "123">]>
<Items>
  <Item>Test with
 an entity: &number;</Item>
  <Item>test with
 a child element <more/>
 stuff</Item>
  <Item>test with
 a CDATA section <![CDATA[<456>]]>
 def</Item>
  <Item>Test with
 an char entity: &#65;</Item>
  <!-- Fourteen chars in this element.-->
  <Item>1234567890ABCD</Item>
</Items>
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader コンストラクタ (String, XmlNodeType, XmlParserContext)

指定した文字列、XmlNodeType、および XmlParserContext を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

Public Sub New ( _
    xmlFragment As String, _
    fragType As XmlNodeType, _
    context As XmlParserContext _
)
Dim xmlFragment As String
Dim fragType As XmlNodeType
Dim context As XmlParserContext

Dim instance As New XmlTextReader(xmlFragment,
 fragType, context)
public XmlTextReader (
    string xmlFragment,
    XmlNodeType fragType,
    XmlParserContext context
)
public:
XmlTextReader (
    String^ xmlFragment, 
    XmlNodeType fragType, 
    XmlParserContext^ context
)
public XmlTextReader (
    String xmlFragment, 
    XmlNodeType fragType, 
    XmlParserContext context
)
public function XmlTextReader (
    xmlFragment : String, 
    fragType : XmlNodeType, 
    context : XmlParserContext
)

パラメータ

xmlFragment

解析する XML フラグメントを含んでいる文字列。

fragType

XML フラグメントの XmlNodeType。これもフラグメント文字列に何を含めることができるかを判断します。下の表を参照してください。

context

xmlFragment の解析先の XmlParserContext。これには、使用する XmlNameTable、エンコーディング、名前空間スコープ、現在の xml:lang、および xml:space スコープが含まれます。

例外例外
例外の種類条件

XmlException

fragType が Element、Attribute、または Document のいずれかの XmlNodeType ではありません。

ArgumentNullException

xmlFragment が null 参照 (Visual Basic では Nothing) です。

解説解説

このコンストラクタは、指定した文字列を XML のフラグメントとして解析します。XML フラグメントが要素または属性の場合は、整形式 XML ドキュメントのルート レベルの規則をバイパスできます。このコンストラクタは、ReadInnerXml から返される文字列を処理できます。

fragType の有効値と、リーダーによる異なるノード型の解析方法の一覧を次の表に示します。

使用例使用例

XML フラグメントを解析する例を次に示します。XmlParserContext とその XmlNamespaceManager を使用して、名前空間の解決を処理します。

Imports System
Imports System.IO
Imports System.Xml

public class Sample 

  public shared sub Main()

    'Create the XML fragment to be parsed.
    Dim xmlFrag as string
 ="<book> " & _
                           "<title>Pride And Prejudice</title>"
 & _
                           "<bk:genre>novel</bk:genre>"
 & _
                           "</book>" 

    'Create the XmlNamespaceManager.
    Dim nt as NameTable = new
 NameTable()
    Dim nsmgr as XmlNamespaceManager = new
 XmlNamespaceManager(nt)
    nsmgr.AddNamespace("bk", "urn:sample")

    'Create the XmlParserContext.
    Dim context as XmlParserContext = new
 XmlParserContext(nothing, nsmgr, nothing,
 XmlSpace.None)

    'Create the reader. 
    Dim reader as XmlTextReader = new
 XmlTextReader(xmlFrag, XmlNodeType.Element, context)
  
    'Parse the XML.  If they exist, display the prefix and  
    'namespace URI of each element.
    while (reader.Read())
      if (reader.IsStartElement())
        if (reader.Prefix=String.Empty)
           Console.WriteLine("<{0}>", reader.LocalName)
        else
            Console.Write("<{0}:{1}>", reader.Prefix,
 reader.LocalName)
            Console.WriteLine(" The namespace URI is "
 + reader.NamespaceURI)
        end if 
      end if
    end while
  
    'Close the reader.
    reader.Close()     
  
  end sub
end class
using System;
using System.IO;
using System.Xml;

public class Sample 
{
  public static void Main()
  {

    //Create the XML fragment to be parsed.
    string xmlFrag ="<book> " +
                    "<title>Pride And Prejudice</title>" +
                    "<bk:genre>novel</bk:genre>" +
                    "</book>"; 

    //Create the XmlNamespaceManager.
    NameTable nt = new NameTable();
    XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
    nsmgr.AddNamespace("bk", "urn:sample");

    //Create the XmlParserContext.
    XmlParserContext context = new XmlParserContext(null,
 nsmgr, null, XmlSpace.None);

    //Create the reader. 
    XmlTextReader reader = new XmlTextReader(xmlFrag, XmlNodeType.Element,
 context);
  
    //Parse the XML.  If they exist, display the prefix and  
    //namespace URI of each element.
    while (reader.Read()){
      if (reader.IsStartElement()){
        if (reader.Prefix==String.Empty)
           Console.WriteLine("<{0}>", reader.LocalName);
        else{
            Console.Write("<{0}:{1}>", reader.Prefix, reader.LocalName);
            Console.WriteLine(" The namespace URI is "
 + reader.NamespaceURI);
        }
      }
    }
  
    //Close the reader.
    reader.Close();     
  
  }
} // End class
#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   // Create the XML fragment to be parsed.
   String^ xmlFrag = "<book> <title>Pride And Prejudice</title>
 <bk:genre>novel</bk:genre> </book>";
   
   // Create the XmlNamespaceManager.
   NameTable^ nt = gcnew NameTable;
   XmlNamespaceManager^ nsmgr = gcnew XmlNamespaceManager( nt );
   nsmgr->AddNamespace( "bk", "urn:sample" );
   
   // Create the XmlParserContext.
   XmlParserContext^ context = gcnew XmlParserContext( nullptr,nsmgr,nullptr,XmlSpace::None
 );
   
   // Create the reader. 
   XmlTextReader^ reader = gcnew XmlTextReader( xmlFrag,XmlNodeType::Element,context
 );
   
   // Parse the XML.  If they exist, display the prefix and  
   // namespace URI of each element.
   while ( reader->Read() )
   {
      if ( reader->IsStartElement() )
      {
         if ( reader->Prefix == String::Empty )
                  Console::WriteLine( "< {0}>", reader->LocalName
 );
         else
         {
            Console::Write( "< {0}: {1}>", reader->Prefix, reader->LocalName
 );
            Console::WriteLine( " The namespace URI is {0}",
 reader->NamespaceURI );
         }
      }
   }

   
   // Close the reader.
   reader->Close();
}

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[]
 args)
    {
        //Create the XML fragment to be parsed.
        String xmlFrag = "<book> " + "<title>Pride And
 Prejudice</title>" 
            + "<bk:genre>novel</bk:genre>" + "</book>";
        //Create the XmlNamespaceManager.
        NameTable nt = new NameTable();
        XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
        nsmgr.AddNamespace("bk", "urn:sample");
        //Create the XmlParserContext.
        XmlParserContext context = new XmlParserContext(null,
 nsmgr, null,
            XmlSpace.None);
        //Create the reader. 
        XmlTextReader reader = new XmlTextReader(xmlFrag, XmlNodeType.Element,
 
            context);
        //Parse the XML.  If they exist, display the prefix and  
        //namespace URI of each element.
        while (reader.Read()) {
            if (reader.IsStartElement()) {
                if (reader.get_Prefix().Equals(String.Empty))
 {
                    Console.WriteLine("<{0}>", reader.get_LocalName());
                }
                else {
                    Console.Write("<{0}:{1}>", reader.get_Prefix()
,
                        reader.get_LocalName());
                    Console.WriteLine(" The namespace URI
 is " + 
                        reader.get_NamespaceURI());
                }
            }
        }
        //Close the reader.
        reader.Close();
    } //main 
} //End class Sample
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader コンストラクタ (String, TextReader, XmlNameTable)

指定した URL、TextReader、および XmlNameTable を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

Public Sub New ( _
    url As String, _
    input As TextReader, _
    nt As XmlNameTable _
)
Dim url As String
Dim input As TextReader
Dim nt As XmlNameTable

Dim instance As New XmlTextReader(url,
 input, nt)
public XmlTextReader (
    string url,
    TextReader input,
    XmlNameTable nt
)
public:
XmlTextReader (
    String^ url, 
    TextReader^ input, 
    XmlNameTable^ nt
)
public XmlTextReader (
    String url, 
    TextReader input, 
    XmlNameTable nt
)
public function XmlTextReader (
    url : String, 
    input : TextReader, 
    nt : XmlNameTable
)

パラメータ

url

外部リソースを解決するために使用する URL。BaseURI は、この値に設定されます。url が null 参照 (Visual Basic では Nothing) の場合は、BaseURI が String.Empty に設定されます。

input

読み取る XML データを格納している TextReader。

nt

使用する XmlNameTable。

例外例外
解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader コンストラクタ (Stream)

指定したストリームを使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

例外例外
例外の種類条件

ArgumentNullException

input が null 参照 (Visual Basic では Nothing) です。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader コンストラクタ (TextReader, XmlNameTable)

指定した TextReader と XmlNameTable を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

Public Sub New ( _
    input As TextReader, _
    nt As XmlNameTable _
)
Dim input As TextReader
Dim nt As XmlNameTable

Dim instance As New XmlTextReader(input,
 nt)
public XmlTextReader (
    TextReader input,
    XmlNameTable nt
)
public:
XmlTextReader (
    TextReader^ input, 
    XmlNameTable^ nt
)
public XmlTextReader (
    TextReader input, 
    XmlNameTable nt
)
public function XmlTextReader (
    input : TextReader, 
    nt : XmlNameTable
)

パラメータ

input

読み取る XML データを格納している TextReader。

nt

使用する XmlNameTable。

例外例外
解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader コンストラクタ (String, TextReader)

指定した URL と TextReader を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

Public Sub New ( _
    url As String, _
    input As TextReader _
)
Dim url As String
Dim input As TextReader

Dim instance As New XmlTextReader(url,
 input)
public XmlTextReader (
    string url,
    TextReader input
)
public:
XmlTextReader (
    String^ url, 
    TextReader^ input
)
public XmlTextReader (
    String url, 
    TextReader input
)
public function XmlTextReader (
    url : String, 
    input : TextReader
)

パラメータ

url

外部リソースを解決するために使用する URL。BaseURI は、この値に設定されます。

input

読み取る XML データを格納している TextReader。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader コンストラクタ (Stream, XmlNameTable)

指定したストリームと XmlNameTable を使用して、XmlTextReader クラスの新しいインスタンスを初期化します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文構文

Public Sub New ( _
    input As Stream, _
    nt As XmlNameTable _
)
Dim input As Stream
Dim nt As XmlNameTable

Dim instance As New XmlTextReader(input,
 nt)
public XmlTextReader (
    Stream input,
    XmlNameTable nt
)
public:
XmlTextReader (
    Stream^ input, 
    XmlNameTable^ nt
)
public XmlTextReader (
    Stream input, 
    XmlNameTable nt
)
public function XmlTextReader (
    input : Stream, 
    nt : XmlNameTable
)

パラメータ

input

読み取る XML データを格納しているストリーム。

nt

使用する XmlNameTable。

例外例外
例外の種類条件

NullReferenceException

input または nt の値が null 参照 (Visual Basic では Nothing) です。

解説解説
プラットフォームプラットフォーム
バージョン情報バージョン情報
参照参照

XmlTextReader プロパティ


パブリック プロパティパブリック プロパティ

  名前 説明
パブリック プロパティ AttributeCount オーバーライドされます。 現在のノードにある属性の数を取得します。
パブリック プロパティ BaseURI オーバーライドされます。 現在のノードのベース URI を取得します。
パブリック プロパティ CanReadBinaryContent オーバーライドされます。 XmlTextReader がバイナリ コンテンツ用の読み取りメソッドを実装するかどうかを示す値を取得します。
パブリック プロパティ CanReadValueChunk オーバーライドされます。 XmlTextReader が ReadValueChunk メソッドを実装しているかどうかを示す値を取得します。
パブリック プロパティ CanResolveEntity オーバーライドされます。 このリーダーがエンティティを解析および解決できるかどうかを示す値を取得します。
パブリック プロパティ Depth オーバーライドされます。 XML ドキュメント内の現在のノードの深さを取得します。
パブリック プロパティ EOF オーバーライドされます。 リーダーがストリームの末尾に配置されているかどうかを示す値を取得します。
パブリック プロパティ HasAttributes  現在のノードが属性を持っているかどうかを示す値を取得します。 ( XmlReader から継承されます。)
パブリック プロパティ HasValue オーバーライドされます。 現在のノードが String.Empty 以外の Value を保持できるかどうかを示す値を取得します。
パブリック プロパティ IsDefault オーバーライドされます。 現在のノードが DTD またはスキーマで定義された既定値から生成された属性かどうかを示す値を取得します。
パブリック プロパティ IsEmptyElement オーバーライドされます。 現在のノードが空の要素 (<MyElement/> など) かどうかを示す値を取得します。
パブリック プロパティ Item  オーバーロードされます。 派生クラスでオーバーライドされると、属性の値を取得します。 ( XmlReader から継承されます。)
パブリック プロパティ LocalName オーバーライドされます。 現在のノードのローカル名を取得します。
パブリック プロパティ Name オーバーライドされます。 現在のノードの限定名を取得します。
パブリック プロパティ NamespaceURI オーバーライドされます。 リーダーが配置されているノードの名前空間 URI (W3C の名前空間の仕様における定義に準拠) を取得します。
パブリック プロパティ NameTable オーバーライドされます。 この実装に関連付けられている XmlNameTable を取得します。
パブリック プロパティ NodeType オーバーライドされます。 現在のノードの種類を取得します。
パブリック プロパティ Prefix オーバーライドされます。 現在のノードに関連付けられた名前空間プリフィックスを取得します。
パブリック プロパティ QuoteChar オーバーライドされます。 属性ノードの値を囲むために使用する引用符文字を取得します。
パブリック プロパティ ReadState オーバーライドされます。 リーダーの状態を取得します。
パブリック プロパティ SchemaInfo  スキーマ検証の結果、現在のノードに割り当てられているスキーマ情報を取得します。 ( XmlReader から継承されます。)
パブリック プロパティ Settings オーバーライドされます。 この XmlTextReader インスタンスを作成するために使用した XmlReaderSettings オブジェクトを取得します。
パブリック プロパティ Value オーバーライドされます。 現在のノードのテキスト値を取得します。
パブリック プロパティ ValueType  現在のノードの共通言語ランタイム (CLR) 型を取得します。 ( XmlReader から継承されます。)
パブリック プロパティ XmlLang オーバーライドされます。 現在の xml:lang スコープを取得します。
パブリック プロパティ XmlSpace オーバーライドされます。 現在の xml:space スコープを取得します。
参照参照

XmlTextReader メソッド


パブリック メソッドパブリック メソッド

( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Close オーバーライドされます。 ReadState を Closed に変更します。
パブリック メソッド Create  オーバーロードされます。 新しい XmlReader インスタンスを作成します。 ( XmlReader から継承されます。)
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
パブリック メソッド GetAttribute オーバーロードされます。 オーバーライドされます。 属性の値を取得します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
パブリック メソッド GetNamespacesInScope 現在スコープ内にあるすべての名前空間が含まれたコレクションを取得します。
パブリック メソッド GetRemainder バッファ内の XML の剰余を取得します。
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 ( Object から継承されます。)
パブリック メソッド HasLineInfo クラスが行情報を返すことができるかどうかを示す値を取得します。
パブリック メソッド IsName  文字列引数が有効な XML 名かどうかを示す値を取得します。 ( XmlReader から継承されます。)
パブリック メソッド IsNameToken  文字列引数が有効な XML 名トークンかどうかを示す値を取得します。 ( XmlReader から継承されます。)
パブリック メソッド IsStartElement  オーバーロードされます。 現在のコンテンツ ノードが開始タグかどうかをテストします。 ( XmlReader から継承されます。)
パブリック メソッド LookupNamespace オーバーライドされます。 現在の要素のスコープ内の名前空間プリフィックスを解決します。
パブリック メソッド MoveToAttribute オーバーロードされます。 オーバーライドされます。 指定した属性へ移動します。
パブリック メソッド MoveToContent  現在のノードがコンテンツ (空白でないテキスト、CDATA、Element、EndElement、EntityReference、または EndEntity) ノードかどうかを確認します。ノードがコンテンツ ノードでない場合、リーダーは、次のコンテンツ ノードまたはファイルの末尾までスキップします。リーダーは、ProcessingInstruction、DocumentType、Comment、Whitespace、または SignificantWhitespace の型のノードをスキップします。 ( XmlReader から継承されます。)
パブリック メソッド MoveToElement オーバーライドされます。 現在の属性ノードを含む要素に移動します。
パブリック メソッド MoveToFirstAttribute オーバーライドされます。 最初の属性に移動します。
パブリック メソッド MoveToNextAttribute オーバーライドされます。 次の属性に移動します。
パブリック メソッド Read オーバーライドされます。 ストリームから次のノードを読み取ります。
パブリック メソッド ReadAttributeValue オーバーライドされます。 属性値を解析して、1 つ以上の text、EntityReference、EndEntity の各ノードに格納します。
パブリック メソッド ReadBase64 Base64 をデコードし、デコードされたバイナリ バイトを返します。
パブリック メソッド ReadBinHex BinHex をデコードし、デコードされたバイナリ バイトを返します。
パブリック メソッド ReadChars 要素のテキストの内容を文字バッファに読み取ります。このメソッドは、連続して呼び出すことによって埋め込みテキストの大量のストリームを読み取るように設計されています。
パブリック メソッド ReadContentAs  指定された型のオブジェクトとして内容を読み取ります。 ( XmlReader から継承されます。)
パブリック メソッド ReadContentAsBase64 オーバーライドされます。 コンテンツを読み取り、Base64 でデコードされたバイナリ バイトを返します。
パブリック メソッド ReadContentAsBinHex オーバーライドされます。 コンテンツを読み取り、BinHex でデコードされたバイナリ バイトを返します。
パブリック メソッド ReadContentAsBoolean  現在の位置でテキストの内容を Boolean として読み取ります。 ( XmlReader から継承されます。)
パブリック メソッド ReadContentAsDateTime  現在の位置でテキストの内容を DateTime オブジェクトとして読み取ります。 ( XmlReader から継承されます。)
パブリック メソッド ReadContentAsDecimal  現在の位置でテキストの内容を Decimal オブジェクトとして読み取ります。 ( XmlReader から継承されます。)
パブリック メソッド ReadContentAsDouble  現在の位置のテキストの内容を、倍精度浮動小数点数として読み取ります。 ( XmlReader から継承されます。)
パブリック メソッド ReadContentAsFloat  現在の位置のテキストの内容を、単精度浮動小数点数として読み取ります。 ( XmlReader から継承されます。)
パブリック メソッド ReadContentAsInt  現在の位置でテキストの内容を 32 ビット符号付き整数として読み取ります。 ( XmlReader から継承されます。)
パブリック メソッド ReadContentAsLong  現在の位置でテキストの内容を 64 ビット符号付き整数として読み取ります。 ( XmlReader から継承されます。)
パブリック メソッド ReadContentAsObject  現在の位置でテキストの内容を Object として読み取ります。 ( XmlReader から継承されます。)
パブリック メソッド ReadContentAsString  現在の位置でテキストの内容を String オブジェクトとして読み取ります。 ( XmlReader から継承されます。)
パブリック メソッド ReadElementContentAs  オーバーロードされます。 現在の要素を読み込み、型指定されたオブジェクトとして内容を返します。 ( XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsBase64 オーバーライドされます。 要素を読み取り、Base64 のコンテンツをデコードします。
パブリック メソッド ReadElementContentAsBinHex オーバーライドされます。 要素を読み取り、BinHex のコンテンツをデコードします。
パブリック メソッド ReadElementContentAsBoolean  オーバーロードされます。 現在の要素の値を Boolean オブジェクトとして読み込みます。 ( XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsDateTime  オーバーロードされます。 現在の要素を読み込み、その内容を DateTime オブジェクトとして返します。 ( XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsDecimal  オーバーロードされます。 現在の要素の値を Decimal オブジェクトとして読み込みます。 ( XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsDouble  オーバーロードされます。 現在の要素を読み込み、その内容を倍精度浮動小数点数として返します。 ( XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsFloat  オーバーロードされます。 現在の要素の値を単精度浮動小数点数として読み込みます。 ( XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsInt  オーバーロードされます。 現在の要素を読み込み、その内容を 32 ビット符号付き整数として返します。 ( XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsLong  オーバーロードされます。 現在の要素を読み込み、その内容を 64 ビット符号付き整数として返します。 ( XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsObject  オーバーロードされます。 現在の要素を読み込み、その内容を Object として返します。 ( XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsString  オーバーロードされます。 現在の要素を読み込み、その内容を String オブジェクトとして返します。 ( XmlReader から継承されます。)
パブリック メソッド ReadElementString  オーバーロードされます。 これは、単純なテキストだけの要素を読み取るためのヘルパー メソッドです。 ( XmlReader から継承されます。)
パブリック メソッド ReadEndElement  現在のコンテンツ ノードが終了タグで、リーダーを次のノードに進めることを確認します。 ( XmlReader から継承されます。)
パブリック メソッド ReadInnerXml  派生クラスでオーバーライドされると、マークアップを含むすべての内容を文字列として読み取ります。 ( XmlReader から継承されます。)
パブリック メソッド ReadOuterXml  派生クラスでオーバーライドされると、このノードとそのすべての子を表す内容 (マークアップを含む) を読み取ります。 ( XmlReader から継承されます。)
パブリック メソッド ReadStartElement  オーバーロードされます。 現在のノードが要素で、リーダーを次のノードに進めるかどうかを確認します。 ( XmlReader から継承されます。)
パブリック メソッド ReadString オーバーライドされます。 要素ノードまたはテキスト ノードの内容を文字列として読み取ります。
パブリック メソッド ReadSubtree  現在のノードおよびそのすべての子孫ノードを読み取るために使用できる、新しい XmlReader インスタンスを返します。 ( XmlReader から継承されます。)
パブリック メソッド ReadToDescendant  オーバーロードされます。 XmlReader を次に一致する子孫要素に進めます。 ( XmlReader から継承されます。)
パブリック メソッド ReadToFollowing  オーバーロードされます。 指定された要素が見つかるまで読み込みます。 ( XmlReader から継承されます。)
パブリック メソッド ReadToNextSibling  オーバーロードされます。 XmlReader を次に一致する兄弟要素に進めます。 ( XmlReader から継承されます。)
パブリック メソッド ReadValueChunk  XML ドキュメントに埋め込まれたテキストの大量のストリームを読み込みます。 ( XmlReader から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
パブリック メソッド ResetState リーダーの状態を ReadState.Initial にリセットします。
パブリック メソッド ResolveEntity オーバーライドされます。 EntityReference ノードのエンティティ参照を解決します。
パブリック メソッド Skip オーバーライドされます。 現在のノードの子をスキップします。
パブリック メソッド ToString  現在の Object を表す String を返します。 ( Object から継承されます。)
プロテクト メソッドプロテクト メソッド
明示的インターフェイスの実装明示的インターフェイスの実装
  名前 説明
インターフェイスの明示的な実装 System.Xml.IXmlNamespaceResolver.GetNamespacesInScope このメンバの説明については、IXmlNamespaceResolver.GetNamespacesInScope のトピックを参照してください。
インターフェイスの明示的な実装 System.Xml.IXmlNamespaceResolver.LookupNamespace このメンバの説明については、IXmlNamespaceResolver.LookupNamespace のトピックを参照してください。
インターフェイスの明示的な実装 System.Xml.IXmlNamespaceResolver.LookupPrefix このメンバの説明については、IXmlNamespaceResolver.LookupPrefix のトピックを参照してください。
参照参照

XmlTextReader メンバ

XML データへの高速で非キャッシュの前方向アクセスを提供するリーダーを表します。

XmlTextReader データ型で公開されるメンバを以下の表に示します。


パブリック コンストラクタパブリック コンストラクタ
プロテクト コンストラクタプロテクト コンストラクタ
パブリック プロパティパブリック プロパティ
  名前 説明
パブリック プロパティ AttributeCount オーバーライドされます。 現在のノードにある属性の数を取得します。
パブリック プロパティ BaseURI オーバーライドされます。 現在のノードのベース URI を取得します。
パブリック プロパティ CanReadBinaryContent オーバーライドされます。 XmlTextReader がバイナリ コンテンツ用の読み取りメソッドを実装するかどうかを示す値を取得します。
パブリック プロパティ CanReadValueChunk オーバーライドされます。 XmlTextReader が ReadValueChunk メソッドを実装しているかどうかを示す値を取得します。
パブリック プロパティ CanResolveEntity オーバーライドされます。 このリーダーがエンティティを解析および解決できるかどうかを示す値を取得します。
パブリック プロパティ Depth オーバーライドされます。 XML ドキュメント内の現在のノードの深さを取得します。
パブリック プロパティ EOF オーバーライドされます。 リーダーがストリームの末尾に配置されているかどうかを示す値を取得します。
パブリック プロパティ HasAttributes  現在のノードが属性を持っているかどうかを示す値を取得します。(XmlReader から継承されます。)
パブリック プロパティ HasValue オーバーライドされます。 現在のノードが String.Empty 以外の Value を保持できるかどうかを示す値を取得します。
パブリック プロパティ IsDefault オーバーライドされます。 現在のノードが DTD またはスキーマで定義された既定値から生成された属性かどうかを示す値を取得します。
パブリック プロパティ IsEmptyElement オーバーライドされます。 現在のノードが空の要素 (<MyElement/> など) かどうかを示す値を取得します。
パブリック プロパティ Item  オーバーロードされます。 派生クラスでオーバーライドされると、属性の値を取得します。(XmlReader から継承されます。)
パブリック プロパティ LocalName オーバーライドされます。 現在のノードのローカル名を取得します。
パブリック プロパティ Name オーバーライドされます。 現在のノードの限定名を取得します。
パブリック プロパティ NamespaceURI オーバーライドされます。 リーダーが配置されているノードの名前空間 URI (W3C の名前空間の仕様における定義に準拠) を取得します。
パブリック プロパティ NameTable オーバーライドされます。 この実装に関連付けられている XmlNameTable を取得します。
パブリック プロパティ NodeType オーバーライドされます。 現在のノードの種類を取得します。
パブリック プロパティ Prefix オーバーライドされます。 現在のノードに関連付けられた名前空間プリフィックスを取得します。
パブリック プロパティ QuoteChar オーバーライドされます。 属性ノードの値を囲むために使用する引用符文字を取得します。
パブリック プロパティ ReadState オーバーライドされます。 リーダーの状態を取得します。
パブリック プロパティ SchemaInfo  スキーマ検証の結果、現在のノードに割り当てられているスキーマ情報を取得します。(XmlReader から継承されます。)
パブリック プロパティ Settings オーバーライドされます。 この XmlTextReader インスタンスを作成するために使用した XmlReaderSettings オブジェクトを取得します。
パブリック プロパティ Value オーバーライドされます。 現在のノードのテキスト値を取得します。
パブリック プロパティ ValueType  現在のノードの共通言語ランタイム (CLR) 型を取得します。(XmlReader から継承されます。)
パブリック プロパティ XmlLang オーバーライドされます。 現在の xml:lang スコープを取得します。
パブリック プロパティ XmlSpace オーバーライドされます。 現在の xml:space スコープを取得します。
パブリック メソッドパブリック メソッド
( プロテクト メソッド も参照)
  名前 説明
パブリック メソッド Close オーバーライドされます。 ReadState を Closed に変更します。
パブリック メソッド Create  オーバーロードされます。 新しい XmlReader インスタンスを作成します。 (XmlReader から継承されます。)
パブリック メソッド Equals  オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
パブリック メソッド GetAttribute オーバーロードされます。 オーバーライドされます。 属性の値を取得します。
パブリック メソッド GetHashCode  特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
パブリック メソッド GetNamespacesInScope 現在スコープ内にあるすべての名前空間が含まれたコレクションを取得します。
パブリック メソッド GetRemainder バッファ内の XML の剰余を取得します。
パブリック メソッド GetType  現在のインスタンスの Type を取得します。 (Object から継承されます。)
パブリック メソッド HasLineInfo クラスが行情報を返すことができるかどうかを示す値を取得します。
パブリック メソッド IsName  文字列引数が有効な XML 名かどうかを示す値を取得します。 (XmlReader から継承されます。)
パブリック メソッド IsNameToken  文字列引数が有効な XML 名トークンかどうかを示す値を取得します。 (XmlReader から継承されます。)
パブリック メソッド IsStartElement  オーバーロードされます。 現在のコンテンツ ノードが開始タグかどうかをテストします。 (XmlReader から継承されます。)
パブリック メソッド LookupNamespace オーバーライドされます。 現在の要素のスコープ内の名前空間プリフィックスを解決します。
パブリック メソッド MoveToAttribute オーバーロードされます。 オーバーライドされます。 指定した属性へ移動します。
パブリック メソッド MoveToContent  現在のノードがコンテンツ (空白でないテキスト、CDATA、Element、EndElement、EntityReference、または EndEntity) ノードかどうかを確認します。ノードがコンテンツ ノードでない場合、リーダーは、次のコンテンツ ノードまたはファイルの末尾までスキップします。リーダーは、ProcessingInstruction、DocumentType、Comment、Whitespace、または SignificantWhitespace の型のノードをスキップします。 (XmlReader から継承されます。)
パブリック メソッド MoveToElement オーバーライドされます。 現在の属性ノードを含む要素に移動します。
パブリック メソッド MoveToFirstAttribute オーバーライドされます。 最初の属性に移動します。
パブリック メソッド MoveToNextAttribute オーバーライドされます。 次の属性に移動します。
パブリック メソッド Read オーバーライドされます。 ストリームから次のノードを読み取ります。
パブリック メソッド ReadAttributeValue オーバーライドされます。 属性値を解析して、1 つ以上の text、EntityReference、EndEntity の各ノードに格納します。
パブリック メソッド ReadBase64 Base64 をデコードし、デコードされたバイナリ バイトを返します。
パブリック メソッド ReadBinHex BinHex をデコードし、デコードされたバイナリ バイトを返します。
パブリック メソッド ReadChars 要素のテキストの内容を文字バッファに読み取ります。このメソッドは、連続して呼び出すことによって埋め込みテキストの大量のストリームを読み取るように設計されています。
パブリック メソッド ReadContentAs  指定された型のオブジェクトとして内容を読み取ります。 (XmlReader から継承されます。)
パブリック メソッド ReadContentAsBase64 オーバーライドされます。 コンテンツを読み取り、Base64 でデコードされたバイナリ バイトを返します。
パブリック メソッド ReadContentAsBinHex オーバーライドされます。 コンテンツを読み取り、BinHex でデコードされたバイナリ バイトを返します。
パブリック メソッド ReadContentAsBoolean  現在の位置でテキストの内容を Boolean として読み取ります。 (XmlReader から継承されます。)
パブリック メソッド ReadContentAsDateTime  現在の位置でテキストの内容を DateTime オブジェクトとして読み取ります。 (XmlReader から継承されます。)
パブリック メソッド ReadContentAsDecimal  現在の位置でテキストの内容を Decimal オブジェクトとして読み取ります。 (XmlReader から継承されます。)
パブリック メソッド ReadContentAsDouble  現在の位置のテキストの内容を、倍精度浮動小数点数として読み取ります。 (XmlReader から継承されます。)
パブリック メソッド ReadContentAsFloat  現在の位置のテキストの内容を、単精度浮動小数点数として読み取ります。 (XmlReader から継承されます。)
パブリック メソッド ReadContentAsInt  現在の位置でテキストの内容を 32 ビット符号付き整数として読み取ります。 (XmlReader から継承されます。)
パブリック メソッド ReadContentAsLong  現在の位置でテキストの内容を 64 ビット符号付き整数として読み取ります。 (XmlReader から継承されます。)
パブリック メソッド ReadContentAsObject  現在の位置でテキストの内容を Object として読み取ります。 (XmlReader から継承されます。)
パブリック メソッド ReadContentAsString  現在の位置でテキストの内容を String オブジェクトとして読み取ります。 (XmlReader から継承されます。)
パブリック メソッド ReadElementContentAs  オーバーロードされます。 現在の要素を読み込み、型指定されたオブジェクトとして内容を返します。 (XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsBase64 オーバーライドされます。 要素を読み取り、Base64 のコンテンツをデコードします。
パブリック メソッド ReadElementContentAsBinHex オーバーライドされます。 要素を読み取り、BinHex のコンテンツをデコードします。
パブリック メソッド ReadElementContentAsBoolean  オーバーロードされます。 現在の要素の値を Boolean オブジェクトとして読み込みます。 (XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsDateTime  オーバーロードされます。 現在の要素を読み込み、その内容を DateTime オブジェクトとして返します。 (XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsDecimal  オーバーロードされます。 現在の要素の値を Decimal オブジェクトとして読み込みます。 (XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsDouble  オーバーロードされます。 現在の要素を読み込み、その内容を倍精度浮動小数点数として返します。 (XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsFloat  オーバーロードされます。 現在の要素の値を単精度浮動小数点数として読み込みます。 (XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsInt  オーバーロードされます。 現在の要素を読み込み、その内容を 32 ビット符号付き整数として返します。 (XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsLong  オーバーロードされます。 現在の要素を読み込み、その内容を 64 ビット符号付き整数として返します。 (XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsObject  オーバーロードされます。 現在の要素を読み込み、その内容を Object として返します。 (XmlReader から継承されます。)
パブリック メソッド ReadElementContentAsString  オーバーロードされます。 現在の要素を読み込み、その内容を String オブジェクトとして返します。 (XmlReader から継承されます。)
パブリック メソッド ReadElementString  オーバーロードされます。 これは、単純なテキストだけの要素を読み取るためのヘルパー メソッドです。 (XmlReader から継承されます。)
パブリック メソッド ReadEndElement  現在のコンテンツ ノードが終了タグで、リーダーを次のノードに進めることを確認します。 (XmlReader から継承されます。)
パブリック メソッド ReadInnerXml  派生クラスでオーバーライドされると、マークアップを含むすべての内容を文字列として読み取ります。 (XmlReader から継承されます。)
パブリック メソッド ReadOuterXml  派生クラスでオーバーライドされると、このノードとそのすべての子を表す内容 (マークアップを含む) を読み取ります。 (XmlReader から継承されます。)
パブリック メソッド ReadStartElement  オーバーロードされます。 現在のノードが要素で、リーダーを次のノードに進めるかどうかを確認します。 (XmlReader から継承されます。)
パブリック メソッド ReadString オーバーライドされます。 要素ノードまたはテキスト ノードの内容を文字列として読み取ります。
パブリック メソッド ReadSubtree  現在のノードおよびそのすべての子孫ノードを読み取るために使用できる、新しい XmlReader インスタンスを返します。 (XmlReader から継承されます。)
パブリック メソッド ReadToDescendant  オーバーロードされます。 XmlReader を次に一致する子孫要素に進めます。 (XmlReader から継承されます。)
パブリック メソッド ReadToFollowing  オーバーロードされます。 指定された要素が見つかるまで読み込みます。 (XmlReader から継承されます。)
パブリック メソッド ReadToNextSibling  オーバーロードされます。 XmlReader を次に一致する兄弟要素に進めます。 (XmlReader から継承されます。)
パブリック メソッド ReadValueChunk  XML ドキュメントに埋め込まれたテキストの大量のストリームを読み込みます。 (XmlReader から継承されます。)
パブリック メソッド ReferenceEquals  指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
パブリック メソッド ResetState リーダーの状態を ReadState.Initial にリセットします。
パブリック メソッド ResolveEntity オーバーライドされます。 EntityReference ノードのエンティティ参照を解決します。
パブリック メソッド Skip オーバーライドされます。 現在のノードの子をスキップします。
パブリック メソッド ToString  現在の Object を表す String を返します。 (Object から継承されます。)
プロテクト メソッドプロテクト メソッド
明示的インターフェイスの実装明示的インターフェイスの実装
  名前 説明
インターフェイスの明示的な実装 System.Xml.IXmlNamespaceResolver.GetNamespacesInScope このメンバの説明については、IXmlNamespaceResolver.GetNamespacesInScope のトピックを参照してください。
インターフェイスの明示的な実装 System.Xml.IXmlNamespaceResolver.LookupNamespace このメンバの説明については、IXmlNamespaceResolver.LookupNamespace のトピックを参照してください。
インターフェイスの明示的な実装 System.Xml.IXmlNamespaceResolver.LookupPrefix このメンバの説明については、IXmlNamespaceResolver.LookupPrefix のトピックを参照してください。
参照参照



英和和英テキスト翻訳

英語⇒日本語日本語⇒英語

辞書ショートカット

すべての辞書の索引

「XmlTextReader」の関連用語

XmlTextReaderのお隣キーワード
検索ランキング

   

英語⇒日本語
日本語⇒英語
   



XmlTextReaderのページの著作権

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2026 Microsoft.All rights reserved.

©2026 GRAS Group, Inc.RSS