XmlValidatingReader 類別

定義

命名空間:

System.Xml

組件:

System.Xml.dll

警告

Use XmlReader created by XmlReader.Create() method using appropriate XmlReaderSettings instead. http://go.microsoft.com/fwlink/?linkid=14202

代表一個讀取器，提供文件類型定義（DTD）、XML-Data 簡化（XDR）架構，以及 XML 架構定義語言（XSD）驗證。

這個類別已經過時。 我們建議你使用該 XmlReaderSettings 類別和 Create 方法來建立一個驗證 XML 讀取器。

public ref class XmlValidatingReader : System::Xml::XmlReader, System::Xml::IXmlLineInfo, System::Xml::IXmlNamespaceResolver

[System.Obsolete("Use XmlReader created by XmlReader.Create() method using appropriate XmlReaderSettings instead. http://go.microsoft.com/fwlink/?linkid=14202")]
public class XmlValidatingReader : System.Xml.XmlReader, System.Xml.IXmlLineInfo, System.Xml.IXmlNamespaceResolver

[<System.Obsolete("Use XmlReader created by XmlReader.Create() method using appropriate XmlReaderSettings instead. http://go.microsoft.com/fwlink/?linkid=14202")>]
type XmlValidatingReader = class
    inherit XmlReader
    interface IXmlLineInfo
    interface IXmlNamespaceResolver

Public Class XmlValidatingReader
Inherits XmlReader
Implements IXmlLineInfo, IXmlNamespaceResolver

繼承

Object

XmlReader

XmlValidatingReader

屬性

ObsoleteAttribute

實作

IXmlLineInfo IXmlNamespaceResolver

備註

XmlValidatingReader 實作該 XmlReader 類別並提供資料驗證支援。 利用該 Schemas 屬性讓讀取器透過快取在 XmlSchemaCollection. 該 ValidationType 屬性指定讀取器應執行何種類型的驗證。 將屬性設為 ValidationType.None 會產生一個非驗證讀取器。

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

Note

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

給繼承者的注意事項

這個階級有繼承需求。 繼承 需要 XmlValidatingReader完全信任。

建構函式

名稱	Description
XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)	已淘汰. 初始化一個新的類別實例 XmlValidatingReader ，並以指定值。
XmlValidatingReader(String, XmlNodeType, XmlParserContext)	已淘汰. 初始化一個新的類別實例 XmlValidatingReader ，並以指定值。
XmlValidatingReader(XmlReader)	已淘汰. 初始化一個新的類別實例 XmlValidatingReader ，以驗證從給定 XmlReader返回的內容。

屬性

名稱	Description
AttributeCount	已淘汰. 取得目前節點上的屬性數量。
BaseURI	已淘汰. 取得目前節點的基礎 URI。
CanReadBinaryContent	已淘汰. 會有一個值，表示是否 XmlValidatingReader 實作了二進位內容讀取方法。
CanReadValueChunk	已淘汰. 會得到一個值，表示是否 XmlReader 實作了該 ReadValueChunk(Char[], Int32, Int32) 方法。 (繼承來源 XmlReader)
CanResolveEntity	已淘汰. 會獲得一個值，表示此讀取器是否能解析並解析實體。
Depth	已淘汰. 取得 XML 文件中目前節點的深度。
Encoding	已淘汰. 取得文件的編碼屬性。
EntityHandling	已淘汰. 取得或設定一個值，指定讀取器如何處理實體。
EOF	已淘汰. 會得到一個值，表示讀取器是否位於串流的末端。
HasAttributes	已淘汰. 會取得一個值，表示目前節點是否有任何屬性。 (繼承來源 XmlReader)
HasValue	已淘汰. 會得到一個值，表示目前節點是否可以有 Value 除 String.Empty 以外的 。
IsDefault	已淘汰. 會取得一個值，表示目前節點是由文件類型定義（DTD）或結構中預設值產生的屬性。
IsEmptyElement	已淘汰. 會得到一個值，表示目前節點是否為空元素（例如， <MyElement/>）。
Item[Int32]	已淘汰. 當在派生類別中覆寫時，會得到具有指定索引的屬性值。 (繼承來源 XmlReader)
Item[String, String]	已淘汰. 當在派生類別中覆寫時，會得到具有指定 LocalName 且 NamespaceURI的屬性值。 (繼承來源 XmlReader)
Item[String]	已淘汰. 當在衍生類別中覆寫時，會得到具有指定 Name屬性的值。 (繼承來源 XmlReader)
LineNumber	已淘汰. 會取得目前的行號。
LinePosition	已淘汰. 會得到目前的線位。
LocalName	已淘汰. 取得目前節點的本地名稱。
Name	已淘汰. 取得目前節點的限定名稱。
Namespaces	已淘汰. 取得或設定一個值，指示是否支援命名空間。
NamespaceURI	已淘汰. 取得讀取器所在節點的命名空間統一資源識別碼（URI）（依據萬維網聯盟（W3C）命名空間規範所定義）。
NameTable	已淘汰. 理解 XmlNameTable 與此實作相關的內容。
NodeType	已淘汰. 會取得目前節點的類型。
Prefix	已淘汰. 取得與目前節點相關的命名空間前綴。
QuoteChar	已淘汰. 取得用來包圍屬性節點值的引號字元。
Reader	已淘汰. 用 XmlReader 來構造這個 XmlValidatingReader。
ReadState	已淘汰. 能感受到讀者的狀態。
SchemaInfo	已淘汰. 取得因結構驗證而指派給當前節點的結構資訊。 (繼承來源 XmlReader)
Schemas	已淘汰. 有 XmlSchemaCollection 個用來驗證的空間。
SchemaType	已淘汰. 會拿到一個結構型物件。
Settings	已淘汰. 取得 XmlReaderSettings 用來建立此 XmlReader 實例的物件。 (繼承來源 XmlReader)
ValidationType	已淘汰. 取得或設定一個值，指示要執行的驗證類型。
Value	已淘汰. 取得當前節點的文字值。
ValueType	已淘汰. 取得目前節點的共通語言執行時（CLR）型別。 (繼承來源 XmlReader)
XmlLang	已淘汰. 取得目前的 xml:lang 瞄準鏡。
XmlResolver	已淘汰. 設定 XmlResolver 用於解析外部文件類型定義（DTD）及結構位置參考的 。 同時 XmlResolver 也用於處理 XML Schema 定義語言（XSD）架構中的任何匯入或包含元素。
XmlSpace	已淘汰. 取得目前的 xml:space 瞄準鏡。

方法

名稱	Description
Close()	已淘汰. 將 改為 ReadState 關閉。
Dispose()	已淘汰. 釋放目前類別實例 XmlReader 所使用的所有資源。 (繼承來源 XmlReader)
Dispose(Boolean)	已淘汰. 釋放 未管理的資源， XmlReader 並可選擇性地釋放受管理資源。 (繼承來源 XmlReader)
Equals(Object)	已淘汰. 判斷指定的 物件是否等於目前的物件。 (繼承來源 Object)
GetAttribute(Int32)	已淘汰. 取得帶有指定索引的屬性值。
GetAttribute(String, String)	已淘汰. 取得具有指定本地名稱與命名空間的屬性值，統一資源識別碼（URI）。
GetAttribute(String)	已淘汰. 取得指定名稱屬性的值。
GetHashCode()	已淘汰. 做為預設雜湊函式。 (繼承來源 Object)
GetType()	已淘汰. 取得目前實例的 Type。 (繼承來源 Object)
GetValueAsync()	已淘汰. 非同步取得目前節點的值。 (繼承來源 XmlReader)
HasLineInfo()	已淘汰. 會得到一個值，表示該類別是否能回傳行資訊。
IsStartElement()	已淘汰. 呼叫 MoveToContent() 並測試目前的內容節點是起始標籤還是空元素標籤。 (繼承來源 XmlReader)
IsStartElement(String, String)	已淘汰. 呼叫MoveToContent()並測試目前的內容節點是起始標籤還是空元素標籤，以及所找到元素的 and LocalName 屬性是否NamespaceURI與給定字串相符。 (繼承來源 XmlReader)
IsStartElement(String)	已淘汰. 呼叫 MoveToContent() 並測試目前的內容節點是起始標籤還是空元素標籤，以及所找到元素的屬性是否 Name 符合給定參數。 (繼承來源 XmlReader)
LookupNamespace(String)	已淘汰. 解析當前元素作用域中的命名空間前綴。
MemberwiseClone()	已淘汰. 建立目前 Object的淺層複本。 (繼承來源 Object)
MoveToAttribute(Int32)	已淘汰. 移動到指定索引的屬性。
MoveToAttribute(String, String)	已淘汰. 移至指定本地名稱與命名空間的屬性 統一資源識別碼（URI）。
MoveToAttribute(String)	已淘汰. 移到指定名稱的屬性。
MoveToContent()	已淘汰. 檢查目前節點是否為內容節點（非空白文字、CDATA、ElementEndElementEntityReference或EndEntity）節點。 若該節點不是內容節點，讀取器會跳到下一個內容節點或檔案的結尾。 它會跳過以下類型的節點：ProcessingInstruction、DocumentTypeCommentWhitespace或。SignificantWhitespace (繼承來源 XmlReader)
MoveToContentAsync()	已淘汰. 非同步檢查目前節點是否為內容節點。 若該節點不是內容節點，讀取器會跳到下一個內容節點或檔案的結尾。 (繼承來源 XmlReader)
MoveToElement()	已淘汰. 移動到包含當前屬性節點的元素。
MoveToFirstAttribute()	已淘汰. 移到第一個屬性。
MoveToNextAttribute()	已淘汰. 進入下一個屬性。
Read()	已淘汰. 讀取串流中的下一個節點。
ReadAsync()	已淘汰. 非同步地從串流讀取下一個節點。 (繼承來源 XmlReader)
ReadAttributeValue()	已淘汰. 將屬性值解析成一個或多個 Text、 EntityReference或 EndEntity 節點。
ReadContentAs(Type, IXmlNamespaceResolver)	已淘汰. 將內容讀取為指定類型的物件。 (繼承來源 XmlReader)
ReadContentAsAsync(Type, IXmlNamespaceResolver)	已淘汰. 非同步讀取內容，作為指定類型的物件。 (繼承來源 XmlReader)
ReadContentAsBase64(Byte[], Int32, Int32)	已淘汰. 讀取內容並回傳 Base64 解碼後的二進位位元組。
ReadContentAsBase64Async(Byte[], Int32, Int32)	已淘汰. 非同步讀取內容並回傳 Base64 解碼後的二進位位元組。 (繼承來源 XmlReader)
ReadContentAsBinHex(Byte[], Int32, Int32)	已淘汰. 讀取內容並回傳 BinHex 解碼後的二進位位元組。
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	已淘汰. 非同步讀取內容並回傳 BinHex 解碼後的二進位位元組。 (繼承來源 XmlReader)
ReadContentAsBoolean()	已淘汰. 將當前位置 Boolean的文字內容以 . 讀取為 。 (繼承來源 XmlReader)
ReadContentAsDateTime()	已淘汰. 以物件形式讀取當前位置 DateTime 的文字內容。 (繼承來源 XmlReader)
ReadContentAsDateTimeOffset()	已淘汰. 以物件形式讀取當前位置 DateTimeOffset 的文字內容。 (繼承來源 XmlReader)
ReadContentAsDecimal()	已淘汰. 以物件形式讀取當前位置 Decimal 的文字內容。 (繼承來源 XmlReader)
ReadContentAsDouble()	已淘汰. 將當前位置的文字內容以雙精度浮點數讀取。 (繼承來源 XmlReader)
ReadContentAsFloat()	已淘汰. 將當前位置的文字內容讀取為單精度浮點數。 (繼承來源 XmlReader)
ReadContentAsInt()	已淘汰. 將當前位置的文字內容讀取為 32 位元有符號整數。 (繼承來源 XmlReader)
ReadContentAsLong()	已淘汰. 將當前位置的文字內容讀取為 64 位元的有號整數。 (繼承來源 XmlReader)
ReadContentAsObject()	已淘汰. 以 . 讀取當前位置 Object的文字內容。 (繼承來源 XmlReader)
ReadContentAsObjectAsync()	已淘汰. 非同步讀取當前位置的文字內容。Object (繼承來源 XmlReader)
ReadContentAsString()	已淘汰. 以物件形式讀取當前位置 String 的文字內容。 (繼承來源 XmlReader)
ReadContentAsStringAsync()	已淘汰. 非同步讀取當前位置的文字內容，作為 String 物件。 (繼承來源 XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	已淘汰. 檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後將元素內容讀取為請求的類型。 (繼承來源 XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver)	已淘汰. 讀取元素內容為請求的類型。 (繼承來源 XmlReader)
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	已淘汰. 非同步讀取元素內容，視為請求的類型。 (繼承來源 XmlReader)
ReadElementContentAsBase64(Byte[], Int32, Int32)	已淘汰. 讀取元素並解碼 Base64 內容。
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	已淘汰. 非同步讀取元素並解碼內容 Base64 。 (繼承來源 XmlReader)
ReadElementContentAsBinHex(Byte[], Int32, Int32)	已淘汰. 讀取元素並解碼 BinHex 內容。
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)	已淘汰. 非同步讀取元素並解碼內容 BinHex 。 (繼承來源 XmlReader)
ReadElementContentAsBoolean()	已淘汰. 讀取目前元素，並將內容以 Boolean 物件形式回傳。 (繼承來源 XmlReader)
ReadElementContentAsBoolean(String, String)	已淘汰. 檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取該當前元素並將內容作為 Boolean 物件回傳。 (繼承來源 XmlReader)
ReadElementContentAsDateTime()	已淘汰. 讀取目前元素，並將內容以 DateTime 物件形式回傳。 (繼承來源 XmlReader)
ReadElementContentAsDateTime(String, String)	已淘汰. 檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取該當前元素並將內容作為 DateTime 物件回傳。 (繼承來源 XmlReader)
ReadElementContentAsDecimal()	已淘汰. 讀取目前元素，並將內容以 Decimal 物件形式回傳。 (繼承來源 XmlReader)
ReadElementContentAsDecimal(String, String)	已淘汰. 檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取該當前元素並將內容作為 Decimal 物件回傳。 (繼承來源 XmlReader)
ReadElementContentAsDouble()	已淘汰. 讀取當前元素，並以雙精度浮點數回傳內容。 (繼承來源 XmlReader)
ReadElementContentAsDouble(String, String)	已淘汰. 檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取當前元素，並以雙精度浮點數回傳內容。 (繼承來源 XmlReader)
ReadElementContentAsFloat()	已淘汰. 讀取當前元素，並以單精度浮點數回傳內容。 (繼承來源 XmlReader)
ReadElementContentAsFloat(String, String)	已淘汰. 檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取當前元素，並以單精度浮點數回傳內容。 (繼承來源 XmlReader)
ReadElementContentAsInt()	已淘汰. 讀取當前元素，並以 32 位元有符號整數回傳內容。 (繼承來源 XmlReader)
ReadElementContentAsInt(String, String)	已淘汰. 檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取該當前元素，並以 32 位元有符號整數回傳內容。 (繼承來源 XmlReader)
ReadElementContentAsLong()	已淘汰. 讀取當前元素，並以 64 位元有符號整數回傳內容。 (繼承來源 XmlReader)
ReadElementContentAsLong(String, String)	已淘汰. 檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取當前元素，並以 64 位元有符號整數的形式回傳內容。 (繼承來源 XmlReader)
ReadElementContentAsObject()	已淘汰. 讀取當前元素並以 Object. (繼承來源 XmlReader)
ReadElementContentAsObject(String, String)	已淘汰. 檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取當前元素並將內容 Object以 . (繼承來源 XmlReader)
ReadElementContentAsObjectAsync()	已淘汰. 非同步讀取目前元素，並將內容返回為 Object。 (繼承來源 XmlReader)
ReadElementContentAsString()	已淘汰. 讀取目前元素，並將內容以 String 物件形式回傳。 (繼承來源 XmlReader)
ReadElementContentAsString(String, String)	已淘汰. 檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取該當前元素並將內容作為 String 物件回傳。 (繼承來源 XmlReader)
ReadElementContentAsStringAsync()	已淘汰. 非同步讀取目前元素，並將內容 String 以物件形式回傳。 (繼承來源 XmlReader)
ReadElementString()	已淘汰. 讀取純文字元素。 不過，我們建議你改用這個 ReadElementContentAsString() 方法，因為它提供了更直接處理此操作的方法。 (繼承來源 XmlReader)
ReadElementString(String, String)	已淘汰. 在讀取純文字元素前，檢查所找到元素的 和 LocalName 屬性是否NamespaceURI與給定字串相符。 不過，我們建議你改用這個 ReadElementContentAsString(String, String) 方法，因為它提供了更直接處理此操作的方法。 (繼承來源 XmlReader)
ReadElementString(String)	已淘汰. 在讀取純文字元素前，檢查所找到元素的屬性是否 Name 與給定字串相符。 不過，我們建議你改用這個 ReadElementContentAsString() 方法，因為它提供了更直接處理此操作的方法。 (繼承來源 XmlReader)
ReadEndElement()	已淘汰. 檢查目前的內容節點是否為終點標籤，並將讀取器推進至下一個節點。 (繼承來源 XmlReader)
ReadInnerXml()	已淘汰. 當在派生類別中覆寫時，會將所有內容（包括標記）讀取為字串。 (繼承來源 XmlReader)
ReadInnerXmlAsync()	已淘汰. 非同步讀取所有內容，包括標記，以字串形式呈現。 (繼承來源 XmlReader)
ReadOuterXml()	已淘汰. 當在衍生類別中覆寫時，會讀取代表該節點及其所有子節點的內容，包括標記。 (繼承來源 XmlReader)
ReadOuterXmlAsync()	已淘汰. 非同步讀取代表該節點及其所有子節點的內容，包括標記。 (繼承來源 XmlReader)
ReadStartElement()	已淘汰. 檢查當前節點是否為元素，並將讀取器推進至下一個節點。 (繼承來源 XmlReader)
ReadStartElement(String, String)	已淘汰. 檢查當前內容節點是否為元素，且為給定 LocalName ， NamespaceURI 並將讀取器推進至下一個節點。 (繼承來源 XmlReader)
ReadStartElement(String)	已淘汰. 檢查當前內容節點是否為與給定 Name 元素的元素，並將讀取器推進至下一個節點。 (繼承來源 XmlReader)
ReadString()	已淘汰. 將元素或文字節點的內容讀取為字串。
ReadSubtree()	已淘汰. 回傳一個新 XmlReader 實例，可用來讀取目前節點及其所有後代節點。 (繼承來源 XmlReader)
ReadToDescendant(String, String)	已淘汰. 將 推進 XmlReader 到下一個具有指定本地名稱與命名空間 URI 的後代元素。 (繼承來源 XmlReader)
ReadToDescendant(String)	已淘汰. 將該 XmlReader 元素推進至指定限定名稱的下一個後裔元素。 (繼承來源 XmlReader)
ReadToFollowing(String, String)	已淘汰. 讀取直到找到具有指定本地名稱與命名空間 URI 的元素。 (繼承來源 XmlReader)
ReadToFollowing(String)	已淘汰. 讀取直到找到具有指定限定名稱的元素為止。 (繼承來源 XmlReader)
ReadToNextSibling(String, String)	已淘汰. 將 XmlReader 推進到下一個具有指定本地名稱與命名空間 URI 的兄弟元素。 (繼承來源 XmlReader)
ReadToNextSibling(String)	已淘汰. 將 XmlReader 推進到具有指定限定名稱的下一個兄弟元素。 (繼承來源 XmlReader)
ReadTypedValue()	已淘汰. 取得指定的 XML Schema 定義語言（XSD）型態的共通語言執行時型別。
ReadValueChunk(Char[], Int32, Int32)	已淘汰. 讀取嵌入 XML 文件中的大量文字流。 (繼承來源 XmlReader)
ReadValueChunkAsync(Char[], Int32, Int32)	已淘汰. 非同步讀取嵌入 XML 文件中的大量文字串流。 (繼承來源 XmlReader)
ResolveEntity()	已淘汰. 解析節點的 EntityReference 實體參考。
Skip()	已淘汰. 跳過目前節點的子節點。 (繼承來源 XmlReader)
SkipAsync()	已淘汰. 非同步跳過目前節點的子節點。 (繼承來源 XmlReader)
ToString()	已淘汰. 傳回表示目前 物件的字串。 (繼承來源 Object)

事件

名稱	Description
ValidationEventHandler	已淘汰. 設置事件處理程序，接收有關文件類型定義（DTD）、XML-Data 簡化（XDR）架構及 XML 架構定義語言（XSD）架構驗證錯誤的資訊。

明確介面實作

名稱	Description
IXmlNamespaceResolver.GetNamespacesInScope(XmlNamespaceScope)	已淘汰. 關於此成員的描述，請參見 GetNamespacesInScope(XmlNamespaceScope)。
IXmlNamespaceResolver.LookupNamespace(String)	已淘汰. 關於此成員的描述，請參見 LookupNamespace(String)。
IXmlNamespaceResolver.LookupPrefix(String)	已淘汰. 關於此成員的描述，請參見 LookupPrefix(String)。

另請參閱

• XmlReader