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) 方法來讀取文字專案。