XmlValidatingReader.ReadString 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlValidatingReader.cs

將元素或文字節點的內容讀取為字串。

public:
 override System::String ^ ReadString();

public override string ReadString();

override this.ReadString : unit -> string

Public Overrides Function ReadString () As String

傳回

String

元素或文字節點的內容。 如果讀取器位於非元素或文字節點上，或當前上下文中沒有更多文字內容可回傳，則該字串可能是空字串。

備註

文字節點可以是元素或屬性文字節點。

備註

這個 XmlValidatingReader 類別在 .NET Framework 2.0 中已經過時。 你可以透過使用XmlReaderSettings類別和Create方法來建立一個驗證實XmlReader例。 如需詳細資訊，請參閱 XmlReader 參考頁面的＜備註＞一節。

若置於元素上，則 ReadString 會將所有文字、顯著空白、空白及 CDATA 區段節點類型串接在一起，並將串接後的資料作為元素內容回傳。 當遇到任何標記，包括註解和處理指令時，讀取器會停止。 這可能發生在混合內容模型中，或當讀取元素結束標籤時。

若置於文字節點上， ReadString 則執行從文字節點到元素結束標籤的相同串接。 如果讀取器位於屬性文字節點上， ReadString 則具有與讀取器位於元素起始標籤相同的功能。 它會回傳所有串接的元素文字節點。

該 EntityHandling 性質決定其運作方式 ReadString 如下：

價值	說明
擴展實體	回傳擴展角色及一般實體。 此為預設值。
擴展角色實體	回傳文字內容，但不包含一般實體參考。 這表示一般實體會讓 ReadString 停止運作。 您必須致電 Read 以跨越實體參考。

另請參閱

• XmlReader