XmlReader.ReadElementString 方法

定義

命名空間:: System.Xml

組件:: netstandard.dll, System.Xml.ReaderWriter.dll

組件:: System.Xml.ReaderWriter.dll

組件:: System.Xml.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

閱讀那些簡單的純文字元素。不過，我們建議你改用這個 ReadElementContentAsString 方法，因為它提供了更直接處理此操作的方法。

多載

名稱	Description
ReadElementString()	讀取純文字元素。不過，我們建議你改用這個 ReadElementContentAsString() 方法，因為它提供了更直接處理此操作的方法。
ReadElementString(String)	在讀取純文字元素前，檢查所找到元素的屬性是否 Name 與給定字串相符。不過，我們建議你改用這個 ReadElementContentAsString() 方法，因為它提供了更直接處理此操作的方法。
ReadElementString(String, String)	在讀取純文字元素前，檢查所找到元素的和 LocalName 屬性是否NamespaceURI與給定字串相符。不過，我們建議你改用這個 ReadElementContentAsString(String, String) 方法，因為它提供了更直接處理此操作的方法。

備註

我們建議你使用此 ReadElementContentAsString 方法來閱讀文字元素。

ReadElementString()

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

讀取純文字元素。不過，我們建議你改用這個 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)

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

在讀取純文字元素前，檢查所找到元素的屬性是否 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)

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

在讀取純文字元素前，檢查所找到元素的和 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) 方法來閱讀文字元素。

適用於

意見反應

此頁面對您有幫助嗎？