XmlTextReader コンストラクター

リファレンス

定義

名前空間:: System.Xml

アセンブリ:: System.Xml.ReaderWriter.dll

アセンブリ:: System.Xml.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

XmlTextReader()	`XmlTextReader`の新しいインスタンスを初期化します。
XmlTextReader(String, XmlNodeType, XmlParserContext)	指定した文字列、XmlNodeType、および XmlParserContext で、XmlTextReader クラスの新しいインスタンスを初期化します。
XmlTextReader(String, TextReader, XmlNameTable)	指定した URL、TextReader、および XmlNameTable で、XmlTextReader クラスの新しいインスタンスを初期化します。
XmlTextReader(String, Stream, XmlNameTable)	指定した URL、ストリーム、および XmlNameTable で、XmlTextReader クラスの新しいインスタンスを初期化します。
XmlTextReader(Stream, XmlNodeType, XmlParserContext)	指定したストリーム、XmlNodeType および XmlParserContext で XmlTextReader クラスの新しいインスタンスを初期化します。
XmlTextReader(String, TextReader)	指定した URL と TextReader で、XmlTextReader クラスの新しいインスタンスを初期化します。
XmlTextReader(String, Stream)	指定した URL とストリームで、XmlTextReader クラスの新しいインスタンスを初期化します。
XmlTextReader(String, XmlNameTable)	指定したファイルと XmlNameTable で、XmlTextReader クラスの新しいインスタンスを初期化します。
XmlTextReader(Stream, XmlNameTable)	指定したストリームと XmlNameTable で XmlTextReader クラスの新しいインスタンスを初期化します。
XmlTextReader(XmlNameTable)	XmlTextReader を指定して、XmlNameTable クラスの新しいインスタンスを初期化します。
XmlTextReader(String)	指定したファイルで、XmlTextReader クラスの新しいインスタンスを初期化します。
XmlTextReader(TextReader)	XmlTextReader を指定して、TextReader クラスの新しいインスタンスを初期化します。
XmlTextReader(Stream)	指定したストリームで XmlTextReader クラスの新しいインスタンスを初期化します。
XmlTextReader(TextReader, XmlNameTable)	指定された XmlTextReader と TextReader を使用して、XmlNameTable クラスの新しいインスタンスを初期化します。

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

XmlTextReader()

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

protected:
 XmlTextReader();

protected XmlTextReader ();

Protected Sub New ()

こちらもご覧ください

XmlReader

適用対象

XmlTextReader(String, XmlNodeType, XmlParserContext)

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

public:
 XmlTextReader(System::String ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);

public XmlTextReader (string xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext? context);

public XmlTextReader (string xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);

new System.Xml.XmlTextReader : string * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlTextReader

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

パラメーター

xmlFragment: String

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

fragType: XmlNodeType

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

context: XmlParserContext

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

例外

XmlException

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

ArgumentNullException

xmlFragment が nullです。

例

次の例では、XML フラグメントを解析します。およびをXmlNamespaceManager使用XmlParserContextして名前空間の解決を処理します。

#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();
}

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

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

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

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

次の表は、の fragType 有効な値と、リーダーが各ノードの種類を解析する方法を示しています。

XmlNodeType	フラグメントに含まれる可能性がある
要素	任意の有効な要素コンテンツ (たとえば、要素、コメント、処理命令、CDATA セクション、テキスト、エンティティ参照の任意の組み合わせ)。 XML 宣言を渡すこともできます。これにより、オブジェクトに設定する必要なく、XML フラグメントのエンコードを XmlParserContext 指定できます。
属性	属性の値 (引用符内の部分)。
ドキュメント	XML ドキュメント全体のコンテンツ。これにより、ドキュメントレベルの規則が適用されます。

こちらもご覧ください

適用対象

XmlTextReader(String, TextReader, XmlNameTable)

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

public:
 XmlTextReader(System::String ^ url, System::IO::TextReader ^ input, System::Xml::XmlNameTable ^ nt);

public XmlTextReader (string url, System.IO.TextReader input, System.Xml.XmlNameTable nt);

new System.Xml.XmlTextReader : string * System.IO.TextReader * System.Xml.XmlNameTable -> System.Xml.XmlTextReader

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

パラメーター

url: String

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

input: TextReader

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

nt: XmlNameTable

使用する XmlNameTable。

例外

ArgumentNullException

nt 値は null です。

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

TextReader が既に正しいエンコーディングに設定されていることを前提にしています。これは、マルチパート MIME シナリオでストリームからいくつかのものを既に読み取っているクライアントによって使用されます。

こちらもご覧ください

XmlReader

適用対象

XmlTextReader(String, Stream, XmlNameTable)

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

public:
 XmlTextReader(System::String ^ url, System::IO::Stream ^ input, System::Xml::XmlNameTable ^ nt);

public XmlTextReader (string url, System.IO.Stream input, System.Xml.XmlNameTable nt);

new System.Xml.XmlTextReader : string * System.IO.Stream * System.Xml.XmlNameTable -> System.Xml.XmlTextReader

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

パラメーター

url: String

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

input: Stream

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

nt: XmlNameTable

使用する XmlNameTable。

例外

NullReferenceException

input または nt の値が null です。

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

こちらもご覧ください

XmlReader

適用対象

XmlTextReader(Stream, XmlNodeType, XmlParserContext)

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

public:
 XmlTextReader(System::IO::Stream ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);

public XmlTextReader (System.IO.Stream xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext? context);

public XmlTextReader (System.IO.Stream xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);

new System.Xml.XmlTextReader : System.IO.Stream * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlTextReader

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

パラメーター

xmlFragment: Stream

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

fragType: XmlNodeType

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

context: XmlParserContext

例外

XmlException

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

ArgumentNullException

xmlFragment が nullです。

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

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

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

XmlNodeType	フラグメントに含まれる可能性がある
`Element`	任意の有効な要素コンテンツ (たとえば、要素、コメント、処理命令、CDATA セクション、テキスト、エンティティ参照の任意の組み合わせ)。 XML 宣言を渡すこともできます。これにより、オブジェクトに設定する必要なく、XML フラグメントのエンコードを XmlParserContext 指定できます。
`Attribute`	属性の値 (引用符内の部分)。
`Document`	XML ドキュメント全体のコンテンツ。これにより、ドキュメントレベルのルールが適用されます。

リーダーは、次を使用してストリームのエンコードを決定します。

プロパティを XmlParserContext.Encoding 調べてエンコードを決定します。
プロパティが Encoding の場合、リーダーは nullストリームの先頭でバイト順マークをチェックします。
プロパティが Encoding で null、バイト順マークが見つからない場合、リーダーはストリームが UTF-8 でエンコードされていることを前提としています。

こちらもご覧ください

XmlReader

適用対象

XmlTextReader(String, TextReader)

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

public:
 XmlTextReader(System::String ^ url, System::IO::TextReader ^ input);

public XmlTextReader (string url, System.IO.TextReader input);

new System.Xml.XmlTextReader : string * System.IO.TextReader -> System.Xml.XmlTextReader

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

パラメーター

url: String

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

input: TextReader

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

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

TextReader が既に正しいエンコーディングに設定されていることを前提にしています。これは、マルチパート MIME シナリオでストリームからいくつかの情報を既に読み取っているクライアントによって使用されます。

こちらもご覧ください

XmlReader

適用対象

XmlTextReader(String, Stream)

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

public:
 XmlTextReader(System::String ^ url, System::IO::Stream ^ input);

public XmlTextReader (string url, System.IO.Stream input);

new System.Xml.XmlTextReader : string * System.IO.Stream -> System.Xml.XmlTextReader

Public Sub New (url As String, input As Stream)

パラメーター

url: String

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

input: Stream

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

例外

ArgumentNullException

input が nullです。

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

こちらもご覧ください

XmlReader

適用対象

XmlTextReader(String, XmlNameTable)

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

public:
 XmlTextReader(System::String ^ url, System::Xml::XmlNameTable ^ nt);

public XmlTextReader (string url, System.Xml.XmlNameTable nt);

new System.Xml.XmlTextReader : string * System.Xml.XmlNameTable -> System.Xml.XmlTextReader

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

パラメーター

url: String

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

nt: XmlNameTable

使用する XmlNameTable。

例外

NullReferenceException

nt 値は null です。

FileNotFoundException

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

DirectoryNotFoundException

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

InvalidOperationException

url が空の文字列です。

WebException

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

- または -

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

UriFormatException

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

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

こちらもご覧ください

XmlReader

適用対象

XmlTextReader(Stream, XmlNameTable)

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

public:
 XmlTextReader(System::IO::Stream ^ input, System::Xml::XmlNameTable ^ nt);

public XmlTextReader (System.IO.Stream input, System.Xml.XmlNameTable nt);

new System.Xml.XmlTextReader : System.IO.Stream * System.Xml.XmlNameTable -> System.Xml.XmlTextReader

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

パラメーター

input: Stream

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

nt: XmlNameTable

使用する XmlNameTable。

例外

NullReferenceException

input または nt の値が null です。

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

は XmlTextReader を使用して System.Text.Encodingストリームをデコードします。

名前テーブルを指定した場合、このコンストラクターは、そのテーブルに既に定義されている名前を使用します。

こちらもご覧ください

XmlReader

適用対象

XmlTextReader(XmlNameTable)

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

protected:
 XmlTextReader(System::Xml::XmlNameTable ^ nt);

protected XmlTextReader (System.Xml.XmlNameTable nt);

new System.Xml.XmlTextReader : System.Xml.XmlNameTable -> System.Xml.XmlTextReader

Protected Sub New (nt As XmlNameTable)

パラメーター

nt: XmlNameTable

使用する XmlNameTable。

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

こちらもご覧ください

XmlReader

適用対象

XmlTextReader(String)

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

public:
 XmlTextReader(System::String ^ url);

public XmlTextReader (string url);

new System.Xml.XmlTextReader : string -> System.Xml.XmlTextReader

Public Sub New (url As String)

パラメーター

url: String

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

例外

FileNotFoundException

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

DirectoryNotFoundException

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

InvalidOperationException

url が空の文字列です。

WebException

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

- または -

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

UriFormatException

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

例

次の例では、XML ファイルを読み取り、各ノードを表示します。

#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();
   }

}

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

Option Strict
Option Explicit

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
End Class

この例では、 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: A</Item>
  <!-- Fourteen chars in this element.-->
  <Item>1234567890ABCD</Item>
</Items>

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

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

注意

.NET Frameworkのバージョン 1.1 では、部分的に信頼されたコードでプロパティをXmlResolver設定できません。回避策は、必要な資格情報を使用してをXmlUrlResolver作成し、URI をメソッドにXmlUrlResolver.GetEntity渡し、結果の 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);

こちらもご覧ください

適用対象

XmlTextReader(TextReader)

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

public:
 XmlTextReader(System::IO::TextReader ^ input);

public XmlTextReader (System.IO.TextReader input);

new System.Xml.XmlTextReader : System.IO.TextReader -> System.Xml.XmlTextReader

Public Sub New (input As TextReader)

パラメーター

input: TextReader

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

例

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

#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();
}

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

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

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

こちらもご覧ください

XmlReader

適用対象

XmlTextReader(Stream)

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

public:
 XmlTextReader(System::IO::Stream ^ input);

public XmlTextReader (System.IO.Stream input);

new System.Xml.XmlTextReader : System.IO.Stream -> System.Xml.XmlTextReader

Public Sub New (input As Stream)

パラメーター

input: Stream

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

例外

ArgumentNullException

input が nullです。

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

は XmlTextReader を使用して System.Text.Encodingストリームをデコードします。

こちらもご覧ください

XmlReader

適用対象

XmlTextReader(TextReader, XmlNameTable)

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

Source:: XmlTextReader.cs

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

public:
 XmlTextReader(System::IO::TextReader ^ input, System::Xml::XmlNameTable ^ nt);

public XmlTextReader (System.IO.TextReader input, System.Xml.XmlNameTable nt);

new System.Xml.XmlTextReader : System.IO.TextReader * System.Xml.XmlNameTable -> System.Xml.XmlTextReader

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

パラメーター

input: TextReader

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

nt: XmlNameTable

使用する XmlNameTable。

例外

NullReferenceException

nt の値は null です。

注釈

注意

.NET Framework 2.0 以降では、メソッドを使用してXmlReader.Create新しい機能を利用してインスタンスを作成XmlReaderすることをお勧めします。

こちらもご覧ください

XmlReader

適用対象