XmlValidatingReader 類別

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.dll

組件:

netstandard.dll

警告

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

警告

XmlValidatingReader has been deprecated. Use XmlReader created by XmlReader.Create() method using appropriate XmlReaderSettings instead.

警告

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

表示讀取器，其提供文件類型定義 (DTD)、XML-Data Reduced (XDR) 結構描述，以及 XML 結構描述定義語言 (XSD) 驗證。

這個類別已經過時。 從 .NET Framework 2.0 開始，我們建議使用 XmlReaderSettings 類別及 Create 方法，來建立驗證 XML 讀取器。

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

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

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

[System.Obsolete("XmlValidatingReader has been deprecated. Use XmlReader created by XmlReader.Create() method using appropriate XmlReaderSettings instead.")]
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")]
public class XmlValidatingReader : System.Xml.XmlReader, System.Xml.IXmlLineInfo, System.Xml.IXmlNamespaceResolver

public class XmlValidatingReader : System.Xml.XmlReader, System.Xml.IXmlLineInfo

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

[<System.Obsolete("XmlValidatingReader has been deprecated. Use XmlReader created by XmlReader.Create() method using appropriate XmlReaderSettings instead.")>]
type XmlValidatingReader = class
    inherit XmlReader
    interface IXmlLineInfo
    interface 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

type XmlValidatingReader = class
    inherit XmlReader
    interface IXmlLineInfo

Public Class XmlValidatingReader
Inherits XmlReader
Implements IXmlLineInfo, IXmlNamespaceResolver

Public Class XmlValidatingReader
Inherits XmlReader
Implements IXmlLineInfo

繼承

Object

XmlReader

XmlValidatingReader

屬性

ObsoleteAttribute

實作

IXmlLineInfo IXmlNamespaceResolver

備註

XmlValidatingReader 會實作 類別 XmlReader ，並提供資料驗證的支援。 Schemas使用 屬性讓讀取器使用 中快取的 XmlSchemaCollection 架構檔案進行驗證。 屬性 ValidationType 會指定讀取器應該執行的驗證類型。 將 屬性設定為 ValidationType.None 會建立非驗證讀取器。

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

注意

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

給繼承者的注意事項

這個類別具有繼承需求。 需要完全信任才能繼承自 XmlValidatingReader 。

建構函式

XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)	使用指定的值，初始化 XmlValidatingReader 類別的新執行個體。
XmlValidatingReader(String, XmlNodeType, XmlParserContext)	使用指定的值，初始化 XmlValidatingReader 類別的新執行個體。
XmlValidatingReader(XmlReader)	初始化驗證從指定的 XmlReader 傳回之內容的 XmlValidatingReader 類別的新執行個體。

屬性

AttributeCount	取得目前節點的屬性數目。
BaseURI	取得目前節點的基底 (Base) URI。
CanReadBinaryContent	取得值，這個值表示 XmlValidatingReader 是否會實作二進位內容讀取方法。
CanReadBinaryContent	取得值，這個值表示 XmlReader 是否會實作二進位內容讀取方法。 (繼承來源 XmlReader)
CanReadValueChunk	取得值，表示 XmlReader 是否會實作 ReadValueChunk(Char[], Int32, Int32) 方法。 (繼承來源 XmlReader)
CanResolveEntity	取得值，指出這個讀取器是否可以剖析和解析實體。
Depth	取得 XML 文件中目前節點的深度。
Encoding	取得文件的編碼屬性。
EntityHandling	取得或設定值，表示讀取器如何處理實體。
EOF	取得值，表示讀取器是否位於資料流結尾。
HasAttributes	取得值，表示目前節點是否具有任何屬性。 (繼承來源 XmlReader)
HasValue	取得值，表示目前的節點是否可以具有 String.Empty 之外的其他 Value。
IsDefault	取得值，表示目前的節點是否為文件類型定義 (DTD)，或結構描述中定義之預設值所產生的屬性。
IsEmptyElement	取得值，指出目前的節點是否為空項目 (例如 <MyElement/>)。
Item[Int32]	取得具有指定索引的屬性值。
Item[Int32]	在衍生類別中覆寫時，取得具有指定索引的屬性值。 (繼承來源 XmlReader)
Item[String, String]	取得具有指定的區域名稱和命名空間 URI 的屬性值。
Item[String, String]	在衍生類別中覆寫時，取得具有指定 LocalName 與 NamespaceURI 的屬性值。 (繼承來源 XmlReader)
Item[String]	取得具有指定名稱的屬性值。
Item[String]	在衍生類別中覆寫時，取得具有指定 Name 的屬性值。 (繼承來源 XmlReader)
LineNumber	取得目前的行號。
LinePosition	取得目前的行位置。
LocalName	取得目前節點的區域名稱。
Name	取得目前節點的限定名稱 (Qualified Name)。
Namespaces	取得或設定值，指出是否支援命名空間。
NamespaceURI	取得讀取器所在之節點的命名空間「統一資源識別元 (URI)」(如全球資訊網協會 (W3C) 命名空間規格所定義)。
NameTable	取得與這個實作關聯的 XmlNameTable。
NodeType	取得目前節點的類型。
Prefix	取得與目前節點相關聯的命名空間前置詞。
QuoteChar	取得用來括住屬性節點值的引號字元。
Reader	取得用來建構這個 XmlValidatingReader 的 XmlReader。
ReadState	取得讀取器的狀態。
SchemaInfo	取得在結構描述驗證之後已指派給目前節點的結構描述資訊。 (繼承來源 XmlReader)
Schemas	取得用來驗證的 XmlSchemaCollection。
SchemaType	取得結構描述類型物件。
Settings	取得 XmlReaderSettings 物件，用於建立這個 XmlValidatingReader 執行個體。
Settings	取得 XmlReaderSettings 物件，用於建立這個 XmlReader 執行個體。 (繼承來源 XmlReader)
ValidationType	取得或設定數值，表示要執行的驗證類型。
Value	取得目前節點的文字值。
ValueType	取得目前節點的 Common Language Runtime (CLR) 型別。 (繼承來源 XmlReader)
XmlLang	取得目前的 xml:lang 範圍。
XmlResolver	設定 XmlResolver，用於解析外部文件類型定義 (DTD) 和結構描述位置參考。 XmlResolver 也可用來處理在 XML 結構描述定義語言 (XSD) 結構描述中找到的任何 Import 或 Include 項目。
XmlSpace	取得目前的 xml:space 範圍。

方法

Close()	將 ReadState 變更為 Closed。
Dispose()	釋放 XmlReader 類別目前的執行個體所使用的全部資源。 (繼承來源 XmlReader)
Dispose(Boolean)	釋放 XmlReader 所使用的 Unmanaged 資源，並選擇性地釋放 Managed 資源。 (繼承來源 XmlReader)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetAttribute(Int32)	取得具有指定索引的屬性值。
GetAttribute(String)	取得具有指定名稱的屬性值。
GetAttribute(String, String)	針對具有指定的區域名稱和命名空間「統一資源識別元 (URI)」的屬性，取得其值。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
GetValueAsync()	非同步取得目前節點的值。 (繼承來源 XmlReader)
HasLineInfo()	取得值，這個值指出類別是否可以傳回行資訊。
IsStartElement()	呼叫 MoveToContent() 並測試目前的內容節點為開頭標記或空白項目標記。 (繼承來源 XmlReader)
IsStartElement(String)	呼叫 MoveToContent() 並測試目前的內容節點為開頭標記或空白項目標記，以及所找到項目的 Name 屬性是否符合指定的引數。 (繼承來源 XmlReader)
IsStartElement(String, String)	呼叫 MoveToContent() 並測試目前的內容節點為開頭標記或空白項目標記，以及所找到項目的 LocalName 與 NamespaceURI 屬性是否符合指定的字串。 (繼承來源 XmlReader)
LookupNamespace(String)	解析目前項目範圍中的命名空間前置詞。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MoveToAttribute(Int32)	移至具有指定索引的屬性。
MoveToAttribute(String)	移至具有指定名稱的屬性。
MoveToAttribute(String, String)	移至具有指定區域名稱和命名空間「統一資源識別元 (URI)」的屬性。
MoveToContent()	檢查目前節點是否為內容 (非空白字元文字、CDATA、Element、EndElement、EntityReference 或 EndEntity) 節點。 如果節點並非內容節點，讀取器會先跳至下一個內容節點或檔案結尾。 它會略過下列型別的節點：ProcessingInstruction、DocumentType、Comment、Whitespace 或 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 已解碼的二進位位元組。
ReadContentAsBase64(Byte[], Int32, Int32)	讀取內容，並傳回 Base64 已解碼的二進位位元組。 (繼承來源 XmlReader)
ReadContentAsBase64Async(Byte[], Int32, Int32)	以非同步的方式讀取內容，並傳回 Base64 已解碼的二進位位元組。 (繼承來源 XmlReader)
ReadContentAsBinHex(Byte[], Int32, Int32)	讀取內容，並傳回 BinHex 已解碼的二進位資料。
ReadContentAsBinHex(Byte[], Int32, Int32)	讀取內容，並傳回 BinHex 已解碼的二進位位元組。 (繼承來源 XmlReader)
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)	以要求之型別的形式讀取項目內容。 (繼承來源 XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以要求之型別的形式讀取項目內容。 (繼承來源 XmlReader)
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	以要求之型別的形式，非同步讀取項目內容。 (繼承來源 XmlReader)
ReadElementContentAsBase64(Byte[], Int32, Int32)	讀取項目，並將 Base64 內容解碼。
ReadElementContentAsBase64(Byte[], Int32, Int32)	讀取項目，並將 Base64 內容解碼。 (繼承來源 XmlReader)
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	以非同步的方式讀取項目，並將 Base64 內容解碼。 (繼承來源 XmlReader)
ReadElementContentAsBinHex(Byte[], Int32, Int32)	讀取項目，並將 BinHex 內容解碼。
ReadElementContentAsBinHex(Byte[], Int32, Int32)	讀取項目，並將 BinHex 內容解碼。 (繼承來源 XmlReader)
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)	檢查Name屬性找到的項目之前讀取純文字的項目符合指定的字串。 不過，我們建議您改用ReadElementContentAsString()方法相反地，因為它會提供較簡單的方式來處理這項作業。 (繼承來源 XmlReader)
ReadElementString(String, String)	檢查LocalName和NamespaceURI項目的屬性找到符合的指定的字串之前讀取純文字的項目。 不過，我們建議您改用ReadElementContentAsString(String, String)方法相反地，因為它會提供較簡單的方式來處理這項作業。 (繼承來源 XmlReader)
ReadEndElement()	檢查目前節點為結尾標記，並使讀取器前進至下一個節點。 (繼承來源 XmlReader)
ReadInnerXml()	在衍生類別中覆寫時，將所有的內容當做字串讀取，包括標記。 (繼承來源 XmlReader)
ReadInnerXmlAsync()	以字串形式非同步讀取所有內容，包括標記。 (繼承來源 XmlReader)
ReadOuterXml()	在衍生類別中覆寫時，讀取代表這個節點及其所有子節點的內容，包括標記。 (繼承來源 XmlReader)
ReadOuterXmlAsync()	非同步讀取表示這個節點及其所有子系的內容，包括標記。 (繼承來源 XmlReader)
ReadStartElement()	檢查以確定目前節點為項目，然後使讀取器前進至下一個節點。 (繼承來源 XmlReader)
ReadStartElement(String)	檢查目前的內容節點是否具有的項目指定Name並使讀取器前進至下一個節點。 (繼承來源 XmlReader)
ReadStartElement(String, String)	檢查目前的內容節點是否具有的項目指定LocalName和NamespaceURI並使讀取器前進至下一個節點。 (繼承來源 XmlReader)
ReadString()	將項目或文字節點的內容當做字串讀取。
ReadSubtree()	傳回新XmlReader可以用來讀取目前的節點及其所有子系的執行個體。 (繼承來源 XmlReader)
ReadToDescendant(String)	往前推進XmlReader下一個子系的項目，具有指定限定名稱。 (繼承來源 XmlReader)
ReadToDescendant(String, String)	往前推進XmlReader下一個子系的項目，使用指定的區域名稱和命名空間 URI。 (繼承來源 XmlReader)
ReadToFollowing(String)	在找到具有指定限定名稱的項目之前讀取。 (繼承來源 XmlReader)
ReadToFollowing(String, String)	在找到具有指定區域名稱和命名空間 URI 的項目之前讀取。 (繼承來源 XmlReader)
ReadToNextSibling(String)	往前推進XmlReader指定限定名稱的下一個同層級項目。 (繼承來源 XmlReader)
ReadToNextSibling(String, String)	將 XmlReader 前移到下一個具有指定區域名稱和命名空間 URI 的同層級項目。 (繼承來源 XmlReader)
ReadTypedValue()	取得指定的 XML 結構描述定義語言 (XSD) 類型的 Common Language Runtime 類型。
ReadValueChunk(Char[], Int32, Int32)	讀取 XML 文件中內嵌之大量文字資料流。 (繼承來源 XmlReader)
ReadValueChunkAsync(Char[], Int32, Int32)	以非同步的方式讀取 XML 文件中內嵌之大量文字資料流。 (繼承來源 XmlReader)
ResolveEntity()	解析 EntityReference 節點的實體參考。
Skip()	略過目前節點的子節點。 (繼承來源 XmlReader)
SkipAsync()	以非同步的方式略過目前節點的子節點。 (繼承來源 XmlReader)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

事件

ValidationEventHandler

設定事件處理常式，用於接收文件類型定義 (DTD)、XML-Data Reduced (XDR) 結構描述和 XML 結構描述定義語言 (XSD) 結構描述驗證錯誤的相關資訊。

明確介面實作

IDisposable.Dispose()	如需這個成員的說明，請參閱 Dispose()。 (繼承來源 XmlReader)
IXmlLineInfo.HasLineInfo()	取得值，這個值指出類別是否可以傳回行資訊。
IXmlNamespaceResolver.GetNamespacesInScope(XmlNamespaceScope)	如需這個成員的說明，請參閱 GetNamespacesInScope(XmlNamespaceScope)。
IXmlNamespaceResolver.LookupNamespace(String)	如需這個成員的說明，請參閱 LookupNamespace(String)。
IXmlNamespaceResolver.LookupPrefix(String)	如需這個成員的說明，請參閱 LookupPrefix(String)。

另請參閱

• XmlReader