XmlReader.ReadElementString

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

XmlReader.ReadElementString メソッド ()

テキストだけの要素を読み取ります。

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

Visual Basic (宣言)

Public Overridable Function
 ReadElementString As String

Visual Basic (使用法)

Dim instance As XmlReader
Dim returnValue As String

returnValue = instance.ReadElementString

C#

public virtual string ReadElementString ()

C++

public:
virtual String^ ReadElementString ()

J#

public String ReadElementString ()

JScript

public function ReadElementString () : String

戻り値
読み取られた要素内に格納されているテキスト。要素が空 (<item></item> または <item/>) の場合は、空の文字列。

例外

例外の種類	条件
XmlException	次のコンテンツ ノードが開始タグでないか、見つかった要素に単純なテキスト値が格納されていません。

解説

これは、単純なテキストだけの要素を読み取るためのヘルパー メソッドです。MoveToContent を呼び出して、次のコンテンツ ノードを検索してから、その値を単純文字列として解析します。

XML、<name>Arlene Huff</name>、ReadElementString を使用すると、要素が処理され、文字列 Arlene Huff が返されます。

このメソッドは name 要素内のマークアップ (子要素、コメント、処理命令など) を処理できませんが、複数の隣接したテキスト ブロックと CDATA ブロックを連結できます。

このメソッドを呼び出すと、EndElement ノードの次のノードまたは空の要素タグの後ろにリーダーが配置されます。

使用例

ReadElementString を使用して、要素ノードの内容を読み取る例を次に示します。

Visual Basic

Imports System
Imports System.Xml

public class Sample

  private const filename as
 string = "book.xml"

  public shared Sub Main()

    Dim reader as XmlTextReader = Nothing

    try
       
      ' Load the file and ignore all white space.
      reader = new XmlTextReader(filename)
      reader.WhitespaceHandling = WhitespaceHandling.None

      ' Moves the reader to the root element.
      reader.MoveToContent()

      ' Read the title and price elements.
      Console.WriteLine("Content of the title element: {0}",
 reader.ReadElementString())
      Console.WriteLine("Content of the price element: {0}",
 reader.ReadElementString())

    finally
      if Not reader Is Nothing
        reader.Close()
      End if
    End try

  End Sub
End class

C#

using System;
using System.Xml;

public class Sample
{
  private const String filename = "book.xml";

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

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

      // Moves the reader to the root element.
      reader.MoveToContent();

      // Read the title and price elements.
      Console.WriteLine("Content of the title element: {0}", reader.ReadElementString());
      Console.WriteLine("Content of the price element: {0}", reader.ReadElementString());;
 
         
    }
    finally
    {
      if (reader!=null)
        reader.Close();
    }
  }
} // End class

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
int main()
{
   String^ filename = "book.xml";
   XmlTextReader^ reader = nullptr;
   try
   {
      
      // Load the file and ignore all white space.
      reader = gcnew XmlTextReader( filename );
      reader->WhitespaceHandling = WhitespaceHandling::None;
      
      // Moves the reader to the root element.
      reader->MoveToContent();
      
      // Read the title and price elements.
      Console::WriteLine( "Content of the title element: {0}", reader->ReadElementString()
 );
      Console::WriteLine( "Content of the price element: {0}", reader->ReadElementString()
 );
   }
   finally
   {
      if ( reader != nullptr )
            reader->Close();
   }

}

J#

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

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

    public static void main(String[]
 args)
    {
        XmlTextReader reader = null;
        try {
            // Load the file and ignore all white space.
            reader = new XmlTextReader(fileName);
            reader.set_WhitespaceHandling(WhitespaceHandling.None);

            // Moves the reader to the root element.
            reader.MoveToContent();

            // Read the title and price elements.
            Console.WriteLine("Content of the title element: {0}",
                reader.ReadElementString());
            Console.WriteLine("Content of the price element: {0}", 
                reader.ReadElementString());
        } 
        finally {
            if (reader != null) {
                reader.Close();
            }
        }
    } // main
} // End class Sample

この例では、データ ファイル book.xml を使用しています。

<!--sample XML fragment-->
<book genre='novel' ISBN='1-861003-78'
 misc='sale-item'>
  <title>The Handmaid's
 Tale</title>
  <price>14.95</price>
</book>

プラットフォーム

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

参照

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

XmlReader.ReadElementString メソッド (String, String)

テキストだけの要素を読み取る前に、見つかった要素の LocalName プロパティと NamespaceURI プロパティが、指定した文字列と一致することを確認します。

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

Visual Basic (宣言)

Public Overridable Function
 ReadElementString ( _
    localname As String, _
    ns As String _
) As String

Visual Basic (使用法)

Dim instance As XmlReader
Dim localname As String
Dim ns As String
Dim returnValue As String

returnValue = instance.ReadElementString(localname, ns)

C#

public virtual string ReadElementString (
    string localname,
    string ns
)

C++

public:
virtual String^ ReadElementString (
    String^ localname, 
    String^ ns
)

J#

public String ReadElementString (
    String localname, 
    String ns
)

JScript

public function ReadElementString (
    localname : String, 
    ns : String
) : String

パラメータ

localname

確認対象のローカル名。

ns

確認対象の名前空間 URI。

戻り値
読み取られた要素内に格納されているテキスト。要素が空 (<item></item> または <item/>) の場合は、空の文字列。

例外

例外の種類	条件
XmlException	次のコンテンツ ノードが開始タグでない、要素 LocalName または NamespaceURI が指定した引数と一致しない、または見つかった要素に単純なテキスト値が含まれていない場合。

解説

これは、単純なテキストだけの要素を読み取るためのヘルパー メソッドです。MoveToContent を呼び出して、次のコンテンツ ノードを検索してから、その値を単純文字列として解析します。

XML、<name>Arlene Huff</name>、ReadElementString を使用すると、要素が処理され、文字列 Arlene Huff が返されます。

このメソッドは name 要素内のマークアップ (子要素、コメント、処理命令など) を処理できませんが、複数の隣接したテキスト ブロックと CDATA ブロックを連結できます。

このメソッドを呼び出すと、EndElement ノードの次のノードまたは空の要素タグの後ろにリーダーが配置されます。

プラットフォーム

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

参照

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

XmlReader.ReadElementString メソッド (String)

テキストだけの要素を読み取る前に、見つかった要素の Name プロパティが、指定した文字列と一致することを確認します。

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

Visual Basic (宣言)

Public Overridable Function
 ReadElementString ( _
    name As String _
) As String

Visual Basic (使用法)

Dim instance As XmlReader
Dim name As String
Dim returnValue As String

returnValue = instance.ReadElementString(name)

C#

public virtual string ReadElementString (
    string name
)

C++

public:
virtual String^ ReadElementString (
    String^ name
)

J#

public String ReadElementString (
    String name
)

JScript

public function ReadElementString (
    name : String
) : String

パラメータ

name

確認対象の名前。

戻り値
読み取られた要素内に格納されているテキスト。要素が空 (<item></item> または <item/>) の場合は、空の文字列。

例外

例外の種類	条件
XmlException	次のコンテンツ ノードが開始タグでない、要素 Name が指定した引数と一致しない、または見つかった要素に単純なテキスト値が含まれていない場合。

解説

これは、単純なテキストだけの要素を読み取るためのヘルパー メソッドです。MoveToContent を呼び出して、次のコンテンツ ノードを検索してから、その値を単純文字列として解析します。

XML、<name>Arlene Huff</name>、ReadElementString を使用すると、要素が処理され、文字列 Arlene Huff が返されます。

このメソッドは name 要素内のマークアップ (子要素、コメント、処理命令など) を処理できませんが、複数の隣接したテキスト ブロックと CDATA ブロックを連結できます。

このメソッドを呼び出すと、EndElement ノードの次のノードまたは空の要素タグの後ろにリーダーが配置されます。

プラットフォーム

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

参照

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

XmlReader.ReadElementString メソッド

これは、単純なテキストだけの要素を読み取るためのヘルパー メソッドです。
オーバーロードの一覧

名前	説明
XmlReader.ReadElementString ()	テキストだけの要素を読み取ります。 .NET Compact Framework によってサポートされています。
XmlReader.ReadElementString (String)	テキストだけの要素を読み取る前に、見つかった要素の Name プロパティが、指定した文字列と一致することを確認します。 .NET Compact Framework によってサポートされています。
XmlReader.ReadElementString (String, String)	テキストだけの要素を読み取る前に、見つかった要素の LocalName プロパティと NamespaceURI プロパティが、指定した文字列と一致することを確認します。 .NET Compact Framework によってサポートされています。

参照

関連項目

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

その他の技術情報

XmlReader による XML の読み取り
XmlReader による XML の読み取り

XmlReader による XML の読み取り