XmlReader.ReadElementContentAsString XmlReader.ReadElementContentAsString XmlReader.ReadElementContentAsString XmlReader.ReadElementContentAsString Method

定義

現在の要素を読み取り、そのコンテンツを String オブジェクトとして返します。Reads the current element and returns the contents as a String object.

オーバーロード

ReadElementContentAsString(String, String) ReadElementContentAsString(String, String) ReadElementContentAsString(String, String) ReadElementContentAsString(String, String)

指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、現在の要素を読み取って、コンテンツを String オブジェクトとして返します。Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a String object.

ReadElementContentAsString() ReadElementContentAsString() ReadElementContentAsString() ReadElementContentAsString()

現在の要素を読み取り、そのコンテンツを String オブジェクトとして返します。Reads the current element and returns the contents as a String object.

ReadElementContentAsString(String, String) ReadElementContentAsString(String, String) ReadElementContentAsString(String, String) ReadElementContentAsString(String, String)

指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、現在の要素を読み取って、コンテンツを String オブジェクトとして返します。Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a String object.

public:
 virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);
public virtual string ReadElementContentAsString (string localName, string namespaceURI);
abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> string
Public Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As String

パラメーター

localName
String String String String

要素のローカル名。The local name of the element.

namespaceURI
String String String String

要素の名前空間 URI。The namespace URI of the element.

戻り値

コンテンツの要素、Stringオブジェクト。The element content as a String object.

例外

XmlReader が要素に配置されません。The XmlReader is not positioned on an element.

または-or-

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。An XmlReader method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

現在の要素には、子要素が含まれています。The current element contains child elements.

- または --or- 要素のコンテンツを String オブジェクトに変換できません。The element content cannot be converted to a String object.

引数に null を渡してメソッドが呼び出されました。The method is called with null arguments.

指定されたローカル名と名前空間 URI は、現在読み取り中の要素と一致しません。The specified local name and namespace URI do not match that of the current element being read.

次の例ではstringValue 、要素を読み取り、テキストの内容を返します (コメントと処理命令は無視されます)。The following example reads the stringValue element and returns the text content (ignoring the comment and processing instruction).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
End Using

この例は、dataFile.xml ファイルを入力として使用します。The example uses the dataFile.xml file as input.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

注釈

このメソッドは、開始タグと要素の内容を読み取り、リーダーを終了要素タグの後ろに移動します。This method reads the start tag, the contents of the element, and moves the reader past the end element tag. エンティティが展開され、処理命令とコメントは無視されます。It expands entities and ignores processing instructions and comments. 要素には、単純なコンテンツのみを含めることができます。The element can only contain simple content. つまり、子要素を持つことはできません。That is, it cannot have child elements.

詳細については、 XmlReaderリファレンスページの「解説」 と W3C XML Schema Part 2 を参照してください。データ型の推奨。For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

ReadElementContentAsString() ReadElementContentAsString() ReadElementContentAsString() ReadElementContentAsString()

現在の要素を読み取り、そのコンテンツを String オブジェクトとして返します。Reads the current element and returns the contents as a String object.

public:
 virtual System::String ^ ReadElementContentAsString();
public virtual string ReadElementContentAsString ();
abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> string
Public Overridable Function ReadElementContentAsString () As String

戻り値

コンテンツの要素、Stringオブジェクト。The element content as a String object.

例外

XmlReader が要素に配置されません。The XmlReader is not positioned on an element.

- または --or-

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。An XmlReader method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

現在の要素には、子要素が含まれています。The current element contains child elements.

または-or- 要素のコンテンツを String オブジェクトに変換できません。The element content cannot be converted to a String object.

引数に null を渡してメソッドが呼び出されました。The method is called with null arguments.

次の例ではstringValue 、要素を読み取り、テキストの内容を返します (コメントと処理命令は無視されます)。The following example reads the stringValue element and returns the text content (ignoring the comment and processing instruction).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString());			
}
Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString())
End Using

この例は、dataFile.xml ファイルを入力として使用します。The example uses the dataFile.xml file as input.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

注釈

このメソッドは、開始タグと要素の内容を読み取り、リーダーを終了要素タグの後ろに移動します。This method reads the start tag, the contents of the element, and moves the reader past the end element tag. エンティティが展開され、処理命令とコメントは無視されます。It expands entities and ignores processing instructions and comments. 要素には、単純なコンテンツのみを含めることができます。The element can only contain simple content. つまり、子要素を持つことはできません。That is, it cannot have child elements.

詳細については、 XmlReaderリファレンスページの「解説」 と W3C XML Schema Part 2 を参照してください。データ型の推奨。For more information, see the Remarks section of the XmlReader reference page and the W3C XML Schema Part 2: Datatypes recommendation.

このメソッドの非同期バージョンについてはReadElementContentAsStringAsync、「」を参照してください。For the asynchronous version of this method, see ReadElementContentAsStringAsync.

適用対象