XmlNodeReader.ReadString メソッド

.NET Framework クラス ライブラリ リファレンス

XmlNodeReader.ReadString メソッド

要素ノードまたはテキスト ノードの内容を文字列として読み取ります。

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

Visual Basic (宣言)

Public Overrides Function
 ReadString As String

Visual Basic (使用法)

Dim instance As XmlNodeReader
Dim returnValue As String

returnValue = instance.ReadString

C#

public override string ReadString ()

C++

public:
virtual String^ ReadString () override

J#

public String ReadString ()

JScript

public override function ReadString () : String

戻り値
要素ノードまたはテキストのようなノード (CDATA、Text ノード、など) の内容。要素ノードまたはテキスト ノード以外にリーダーが配置されている場合、または返す対象となるテキスト コンテンツが現在のコンテキスト内にこれ以上ない場合は、これが空の文字列になる場合があります。 メモ: テキスト ノードは、要素ノードまたは属性ノードのいずれかにできます。

解説

メモ
Microsoft .NET Framework version 2.0 では、XmlReaderSettings クラスと Create メソッドを使用して XmlReader インスタンスを作成することをお勧めします。これにより、.NET Framework で導入されたすべての新機能を十分に活用できます。詳細については、「XML リーダーの作成」を参照してください。

要素に配置すると、ReadString は、すべてのテキスト、有意な空白、空白、および CData セクション ノード型を連結し、連結したデータを要素の内容として返します。マークアップが検出されると中断します。これは、混合コンテンツ モデル内で、または要素終了タグが読み取られるときに、発生する可能性があります。

テキストのようなノードに配置されると、ReadString は、テキスト ノードから要素終了タグへ同じ連結を実行します。リーダーが属性テキスト ノードに配置されている場合、ReadString は、リーダーが要素開始タグに配置されている場合と同じ機能を持ちます。連結された要素テキスト ノードをすべて返します。

使用例

各要素のテキストの内容を表示する例を次に示します。

Visual Basic

Option Strict
Option Explicit

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        Dim reader As XmlNodeReader = Nothing
        
        Try
            'Create and load the XML document.
            Dim doc As New
 XmlDocument()
            doc.LoadXml("<book>" & _
                        "<title>Pride And Prejudice</title>"
 & _
                        "<price>19.95</price>"
 & _
                        "<misc/>" & _
                        "</book>")
            
            'Load the XmlNodeReader 
            reader = New XmlNodeReader(doc)
            
            'Parse the XML and display the text content of each of the
 elements.
            While reader.Read()
                If reader.IsStartElement() Then
                    If reader.IsEmptyElement Then
                        Console.WriteLine("<{0}/>",
 reader.Name)
                    Else
                        Console.Write("<{0}> ",
 reader.Name)
                        reader.Read() 'Read the start tag.
                        If (reader.IsStartElement())  'Handle
 nested elements.
                          Console.WriteLine()
                          Console.Write("<{0}>",
 reader.Name)
                        End If
                        Console.WriteLine(reader.ReadString()) 'Read
 the text content of the element.
                    End If
                End If
            End While
        Finally
            If Not (reader Is
 Nothing) Then
                reader.Close()
            End If
        End Try
    End Sub 'Main 
End Class 'Sample

C#

using System;
using System.IO;
using System.Xml;

public class Sample 
{
  public static void Main()
  {
    XmlNodeReader reader = null;

    try
    {
       //Create and load the XML document.
       XmlDocument doc = new XmlDocument();
       doc.LoadXml("<book>" +
                   "<title>Pride And Prejudice</title>" +
                   "<price>19.95</price>" +
                   "<misc/>" +
                   "</book>"); 

       //Load the XmlNodeReader 
       reader = new XmlNodeReader(doc);
  
       //Parse the XML and display the text content of each of the elements.
       while (reader.Read()){
         if (reader.IsStartElement()){
           if (reader.IsEmptyElement)
              Console.WriteLine("<{0}/>", reader.Name);
           else{
               Console.Write("<{0}> ", reader.Name);
               reader.Read(); //Read the start tag.
               if (reader.IsStartElement())  //Handle
 nested elements.
                   Console.Write("\r\n<{0}>", reader.Name);
               Console.WriteLine(reader.ReadString());  //Read the text
 content of the element.
           }
         }
       } 
       
     } 

     finally 
     {
        if (reader != null)
          reader.Close();
      }
  }
  
} // End class

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlNodeReader^ reader = nullptr;
   try
   {
      
      //Create and load the XML document.
      XmlDocument^ doc = gcnew XmlDocument;
      doc->LoadXml( "<book>"
      "<title>Pride And Prejudice</title>"
      "<price>19.95</price>"
      "<misc/>"
      "</book>" );
      
      //Load the XmlNodeReader 
      reader = gcnew XmlNodeReader( doc );
      
      //Parse the XML and display the text content of each of the elements.
      while ( reader->Read() )
      {
         if ( reader->IsStartElement() )
         {
            if ( reader->IsEmptyElement )
                        Console::WriteLine( "<{0}/>", reader->Name
 );
            else
            {
               Console::Write( "<{0}> ", reader->Name );
               reader->Read(); //Read the start tag.
               if ( reader->IsStartElement() )
                              
               //Handle nested elements.
               Console::Write( "\r\n<{0}>", reader->Name );
               Console::WriteLine( reader->ReadString() ); //Read
 the text content of the element.
            }
         }
      }
   }
   finally
   {
      if ( reader != nullptr )
            reader->Close();
   }

}

J#

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

public class Sample
{
    public static void main(String[]
 args)
    {
        XmlNodeReader reader = null;
        try {
            //Create and load the XML document.
            XmlDocument doc = new XmlDocument();
            doc.LoadXml("<book>"
                + "<title>Pride And Prejudice</title>"
                + "<price>19.95</price>"
                + "<misc/>" 
                + "</book>");

            //Load the XmlNodeReader 
            reader = new XmlNodeReader(doc);

            // Parse the XML and display the text content of 
            // each of the elements.
            while (reader.Read()) {
                if (reader.IsStartElement()) {
                    if (reader.get_IsEmptyElement()) {
                        Console.WriteLine("<{0}/>", reader.get_Name());
                    }
                    else {
                        Console.Write("<{0}> ", reader.get_Name());
                        //Read the start tag.
                        reader.Read(); 
                        //Handle nested elements.
                        if (reader.IsStartElement()) { 
                            Console.Write("\r\n<{0}>", reader.get_Name());
                        }
                        //Read the text content of the element.
                        Console.WriteLine(reader.ReadString()); 
                    }
                }
            }
        }     
        finally {
            if (reader != null) {
                reader.Close();
         }
      }
    } //main
} // End class Sample

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
XmlNodeReader クラス
XmlNodeReader メンバ
System.Xml 名前空間
その他の技術情報
XmlReader による XML の読み取り