XmlReader.ReadElementContentAsString 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

讀取目前元素，並將內容以 String 物件形式回傳。

多載

名稱	Description
ReadElementContentAsString(String, String)	檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取該當前元素並將內容作為 String 物件回傳。
ReadElementContentAsString()	讀取目前元素，並將內容以 String 物件形式回傳。

ReadElementContentAsString(String, String)

來源:

XmlReader.cs

檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取該當前元素並將內容作為 String 物件回傳。

public:
 virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);

public virtual string ReadElementContentAsString(string localName, string namespaceURI);

abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> string

Public Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As String

參數

localName

String

該元素的地方名稱。

namespaceURI

String

元素的命名空間 URI。

傳回

String

元素內容作為 String 物件。

例外狀況

InvalidOperationException

它 XmlReader 並未被定位在元素上。

-或-

在先前非同步操作結束前，會呼叫一個 XmlReader 方法。 此時， InvalidOperationException 會拋出「非同步操作已進行中」的訊息。

XmlException

目前元素包含子元素。

-或-

元素內容無法轉換成 String 物件。

ArgumentNullException

此方法以參數呼叫 null 。

ArgumentException

指定的本地名稱與命名空間 URI 與目前被讀取的元素不符。

範例

以下範例讀取該 stringValue 元素並回傳文字內容（忽略註解與處理指令）。

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
End Using

範例中以該 dataFile.xml 檔案作為輸入。

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

備註

此方法讀取起始標籤、元素內容，並將讀取器移過終點元素標籤。 它會擴展實體，並忽略處理指令與註解。 該元素只能包含簡單內容。 也就是說，它不能有子元素。

欲了解更多資訊，請參閱參考文獻頁面的 XmlReader 備註區及 W3C XML 架構第二部分：資料型別 建議。

ReadElementContentAsString()

來源:

XmlReader.cs

讀取目前元素，並將內容以 String 物件形式回傳。

public:
 virtual System::String ^ ReadElementContentAsString();

public virtual string ReadElementContentAsString();

abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> string

Public Overridable Function ReadElementContentAsString () As String

傳回

String

元素內容作為 String 物件。

例外狀況

InvalidOperationException

它 XmlReader 並未被定位在元素上。

-或-

在先前非同步操作結束前，會呼叫一個 XmlReader 方法。 此時， InvalidOperationException 會拋出「非同步操作已進行中」的訊息。

XmlException

目前元素包含子元素。

-或-

元素內容無法轉換成 String 物件。

ArgumentNullException

此方法以參數呼叫 null 。

範例

以下範例讀取該 stringValue 元素並回傳文字內容（忽略註解與處理指令）。

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString());			
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString())
End Using

範例中以該 dataFile.xml 檔案作為輸入。

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

備註

此方法讀取起始標籤、元素內容，並將讀取器移過終點元素標籤。 它會擴展實體，並忽略處理指令與註解。 該元素只能包含簡單內容。 也就是說，它不能有子元素。

欲了解更多資訊，請參閱參考文獻頁面的 XmlReader 備註區及 W3C XML 架構第二部分：資料型別 建議。

關於此方法的非同步版本，請參見 ReadElementContentAsStringAsync。