XmlReader.ReadElementString XmlReader.ReadElementString XmlReader.ReadElementString XmlReader.ReadElementString Method

定義

単純なテキストのみの要素を読み取ります。Reads the simple text-only elements. ただし、ReadElementContentAsString メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。However, we recommend that you use the ReadElementContentAsString method instead, because it provides a more straightforward way to handle this operation.

オーバーロード

ReadElementString() ReadElementString() ReadElementString() ReadElementString()

テキストだけの要素を読み取ります。Reads a text-only element. ただし、ReadElementContentAsString() メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

ReadElementString(String) ReadElementString(String) ReadElementString(String) ReadElementString(String)

テキストだけの要素を読み取る前に、見つかった要素の Name プロパティが、指定した文字列と一致することを確認します。Checks that the Name property of the element found matches the given string before reading a text-only element. ただし、ReadElementContentAsString() メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

ReadElementString(String, String) ReadElementString(String, String) ReadElementString(String, String) ReadElementString(String, String)

テキストだけの要素を読み取る前に、見つかった要素の LocalName プロパティと NamespaceURI プロパティが、指定した文字列と一致することを確認します。Checks that the LocalName and NamespaceURI properties of the element found matches the given strings before reading a text-only element. ただし、ReadElementContentAsString(String, String) メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。However, we recommend that you use the ReadElementContentAsString(String, String) method instead, because it provides a more straightforward way to handle this operation.

注釈

使用することをお勧め、ReadElementContentAsStringテキスト要素を読み取ります。We recommend that you use the ReadElementContentAsString method to read a text element.

ReadElementString() ReadElementString() ReadElementString() ReadElementString()

テキストだけの要素を読み取ります。Reads a text-only element. ただし、ReadElementContentAsString() メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

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

戻り値

読み取られた要素内に格納されているテキスト。The text contained in the element that was read. 要素が空の場合は、空の文字列。An empty string if the element is empty.

例外

次のコンテンツ ノードが開始タグでないか、見つかった要素に単純なテキスト値が格納されていません。The next content node is not a start tag; or the element found does not contain a simple text value.

先行の非同期操作が完了する前に、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."

注釈

使用することをお勧め、ReadElementContentAsString()テキスト要素を読み取ります。We recommend that you use the ReadElementContentAsString() method to read a text element.

ReadElementString(String) ReadElementString(String) ReadElementString(String) ReadElementString(String)

テキストだけの要素を読み取る前に、見つかった要素の Name プロパティが、指定した文字列と一致することを確認します。Checks that the Name property of the element found matches the given string before reading a text-only element. ただし、ReadElementContentAsString() メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。However, we recommend that you use the ReadElementContentAsString() method instead, because it provides a more straightforward way to handle this operation.

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

パラメーター

name
String String String String

確認対象の名前。The name to check.

戻り値

読み取られた要素内に格納されているテキスト。The text contained in the element that was read. 要素が空の場合は、空の文字列。An empty string if the element is empty.

例外

次のコンテンツ ノードが開始タグでない、要素 Name が指定した引数と一致しない、または見つかった要素に単純なテキスト値が含まれていない場合。If the next content node is not a start tag; if the element Name does not match the given argument; or if the element found does not contain a simple text value.

先行の非同期操作が完了する前に、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."

注釈

使用することをお勧め、ReadElementContentAsString()テキスト要素を読み取ります。We recommend that you use the ReadElementContentAsString() method to read a text element.

ReadElementString(String, String) ReadElementString(String, String) ReadElementString(String, String) ReadElementString(String, String)

テキストだけの要素を読み取る前に、見つかった要素の LocalName プロパティと NamespaceURI プロパティが、指定した文字列と一致することを確認します。Checks that the LocalName and NamespaceURI properties of the element found matches the given strings before reading a text-only element. ただし、ReadElementContentAsString(String, String) メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。However, we recommend that you use the ReadElementContentAsString(String, String) method instead, because it provides a more straightforward way to handle this operation.

public:
 virtual System::String ^ ReadElementString(System::String ^ localname, System::String ^ ns);
public virtual string ReadElementString (string localname, string ns);
abstract member ReadElementString : string * string -> string
override this.ReadElementString : string * string -> string
Public Overridable Function ReadElementString (localname As String, ns As String) As String

パラメーター

localname
String String String String

確認対象のローカル名。The local name to check.

ns
String String String String

確認対象の名前空間 URI。The namespace URI to check.

戻り値

読み取られた要素内に格納されているテキスト。The text contained in the element that was read. 要素が空の場合は、空の文字列。An empty string if the element is empty.

例外

次のコンテンツ ノードが開始タグでない、要素 LocalName または NamespaceURI が指定した引数と一致しない、または見つかった要素に単純なテキスト値が含まれていない場合。If the next content node is not a start tag; if the element LocalName or NamespaceURI do not match the given arguments; or if the element found does not contain a simple text value.

先行の非同期操作が完了する前に、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."

注釈

使用することをお勧め、ReadElementContentAsString(String, String)テキスト要素を読み取ります。We recommend that you use the ReadElementContentAsString(String, String) method to read a text element.

適用対象