XmlReader.ReadElementString メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

アセンブリ:

System.Xml.dll

アセンブリ:

netstandard.dll

単純なテキストのみの要素を読み取ります。 ただし、ReadElementContentAsString メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。

オーバーロード

ReadElementString()	テキストのみの要素を読みます。 ただし、ReadElementContentAsString() メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。
ReadElementString(String)	テキストだけの要素を読み取る前に、見つかった要素の Name プロパティが、指定した文字列と一致することを確認します。 ただし、ReadElementContentAsString() メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。
ReadElementString(String, String)	テキストだけの要素を読み取る前に、見つかった要素の LocalName プロパティと NamespaceURI プロパティが、指定した文字列と一致することを確認します。 ただし、ReadElementContentAsString(String, String) メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。

注釈

このメソッドを使用 ReadElementContentAsString してテキスト要素を読み取うことをお勧めします。

ReadElementString()

テキストのみの要素を読みます。 ただし、ReadElementContentAsString() メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。

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

戻り値

String

読み取られた要素内に格納されているテキスト。 要素が空の場合は、空の文字列。

例外

XmlException

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

InvalidOperationException

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

注釈

このメソッドを使用 ReadElementContentAsString() してテキスト要素を読み取うことをお勧めします。

ReadElementString(String)

テキストだけの要素を読み取る前に、見つかった要素の Name プロパティが、指定した文字列と一致することを確認します。 ただし、ReadElementContentAsString() メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。

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

読み取られた要素内に格納されているテキスト。 要素が空の場合は、空の文字列。

例外

XmlException

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

InvalidOperationException

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

注釈

このメソッドを使用 ReadElementContentAsString() してテキスト要素を読み取うことをお勧めします。

ReadElementString(String, String)

テキストだけの要素を読み取る前に、見つかった要素の LocalName プロパティと NamespaceURI プロパティが、指定した文字列と一致することを確認します。 ただし、ReadElementContentAsString(String, String) メソッドを代わりに使用するほうが、この操作を簡単に処理できるため、こちらの方法をお勧めします。

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

確認対象のローカル名。

ns

String

確認対象の名前空間 URI。

戻り値

String

読み取られた要素内に格納されているテキスト。 要素が空の場合は、空の文字列。

例外

XmlException

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

InvalidOperationException

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

注釈

このメソッドを使用 ReadElementContentAsString(String, String) してテキスト要素を読み取うことをお勧めします。