XmlReader.ReadElementString 方法

定義

讀取簡單純文字項目。 不過,我們建議您改用ReadElementContentAsString方法相反地,因為它會提供較簡單的方式來處理這項作業。

多載

ReadElementString()

讀取純文字項目。 不過,我們建議您改用ReadElementContentAsString()方法相反地,因為它會提供較簡單的方式來處理這項作業。

ReadElementString(String)

檢查Name屬性找到的項目之前讀取純文字的項目符合指定的字串。 不過,我們建議您改用ReadElementContentAsString()方法相反地,因為它會提供較簡單的方式來處理這項作業。

ReadElementString(String, String)

檢查LocalNameNamespaceURI項目的屬性找到符合的指定的字串之前讀取純文字的項目。 不過,我們建議您改用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

讀取的項目中所含的文字。 當字串為空白時,則為空字串。

例外狀況

下一個內容節點不是開始標記。或找到的項目未包含簡單的文字值。

在先前的非同步作業完成前呼叫了 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

讀取的項目中所含的文字。 當字串為空白時,則為空字串。

例外狀況

如果下一個內容節點不是開始標記。如果項目Name不符合指定的引數; 或如果找到的項目不包含簡單的文字值。

在先前的非同步作業完成前呼叫了 XmlReader 方法。 在此情況下,會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

備註

建議您使用 ReadElementContentAsString() 方法來讀取文字專案。

適用於

ReadElementString(String, String)

檢查LocalNameNamespaceURI項目的屬性找到符合的指定的字串之前讀取純文字的項目。 不過,我們建議您改用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

讀取的項目中所含的文字。 當字串為空白時,則為空字串。

例外狀況

如果下一個內容節點不是開始標記。如果項目LocalNameNamespaceURI不符合指定的引數; 或如果找到的項目不包含簡單的文字值。

在先前的非同步作業完成前呼叫了 XmlReader 方法。 在此情況下,會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

備註

建議您使用 ReadElementContentAsString(String, String) 方法來讀取文字專案。

適用於