System.Xml.XmlTextReader 類別

本文提供此 API 參考文件的補充備註。

注意

建議您使用 XmlReader.Create 方法來建立XmlReader實例，以利用新功能。

XmlTextReader 提供 XML 數據流的正向唯讀存取權。所謂目前節點，是指讀取器定位所在的節點。讀取器會使用任何讀取方法和屬性來進階，以反映目前節點的值。

這個類別會實作 XmlReader 並符合 W3C 可延伸標記語言（XML） 1.0 和 XML 建議中的命名空間。 XmlTextReader 提供下列功能：

強制執行格式正確的 XML 規則。
XmlTextReader 不提供數據驗證。
DocumentType檢查節點的格式是否正確。 XmlTextReader 會檢查 DTD 的格式是否正確，但不會使用 DTD 進行驗證。
對於為的NodeType節點，會傳回單一空白EntityReference節點（也就是 Value 屬性為 String.Empty）。XmlNodeType.EntityReference

注意

DTD 中實體的實際宣告稱為 Entity 節點。當您參考數據中的這些節點時，這些節點稱為 EntityReference 節點。

XmlTextReader由於不會執行數據驗證所需的額外檢查，因此可提供快速格式正確的剖析器。

若要執行資料驗證，請使用驗證 XmlReader。

若要從 XmlDocument讀取 XML 資料，請使用 XmlNodeReader。

XmlTextReader 在 XmlException XML 剖析錯誤上擲回。擲回例外狀況之後，讀取器的狀態無法預測。例如，回報的節點類型可能與目前節點的實際節點類型不同。 ReadState使用屬性來檢查讀取器是否處於錯誤狀態。

安全性考量

以下是使用 XmlTextReader 類別時要考慮的事項。

擲回 XmlTextReader 的例外狀況可能會揭露您不想要反升至應用程式的路徑資訊。應用程式必須捕捉例外狀況並予以適當處理。
DTD 處理預設會啟用。如果您擔心拒絕服務問題，或處理不受信任的來源，請停用 DTD 處理。將 DtdProcessing 屬性設定為 Prohibit 以停用 DTD 處理。

如果已啟用 DTD 處理，則可使用 XmlSecureResolver 限制 XmlTextReader 可存取的資源。您還可以設計應用程式，讓 XML 處理具有記憶體和時間限制。例如，在 ASP.NET 應用程式中設定逾時限制。
XML 資料可以包含外部資源的參考，例如 DTD 檔案。依預設，外部資源會使用不具使用者認證的 XmlUrlResolver 物件來解析。您可以透過執行下列其中一項作業，進一步保護它：
- 藉由將 XmlTextReader 屬性設為 XmlResolver 物件，限制 XmlSecureResolver 可以存取的資源。
- 藉由將 XmlReader 屬性設為 XmlResolver，來禁止 null 開啟外部資源。
XML 資料可以包含需要相當長時間來處理的大量屬性、命名空間宣告、巢狀項目等。若要限制傳送至 XmlTextReader的輸入大小，請建立自定義 IStream 實作並提供。XmlTextReader
ReadValueChunk方法可用來處理大型數據流。此方法每次會讀取較少數量的字元，而不是為整個值配置單一字串。
依預設不會展開一般實體。當呼叫 ResolveEntity 方法時，會展開一般實體。