XmlValidatingReader 建構函式
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
初始化 XmlValidatingReader 類別的新執行個體。
多載
| 名稱 | Description |
|---|---|
| XmlValidatingReader(XmlReader) |
初始化一個新的類別實例 |
| XmlValidatingReader(Stream, XmlNodeType, XmlParserContext) |
初始化一個新的類別實例 |
| XmlValidatingReader(String, XmlNodeType, XmlParserContext) |
初始化一個新的類別實例 |
XmlValidatingReader(XmlReader)
初始化一個新的類別實例 XmlValidatingReader ，以驗證從給定 XmlReader返回的內容。
public:
XmlValidatingReader(System::Xml::XmlReader ^ reader);public XmlValidatingReader(System.Xml.XmlReader reader);new System.Xml.XmlValidatingReader : System.Xml.XmlReader -> System.Xml.XmlValidatingReaderPublic Sub New (reader As XmlReader)參數
- reader
- XmlReader
XmlReader在驗證時，應該閱讀的重點。 目前實作僅 XmlTextReader支援 。
例外狀況
指定的讀取器並非 XmlTextReader。
備註
備註
這個 XmlValidatingReader 類別在 .NET Framework 2.0 中已經過時。 你可以透過使用XmlReaderSettings類別和Create方法來建立一個驗證實XmlReader例。 如需詳細資訊，請參閱 XmlReader 參考頁面的＜備註＞一節。
所有從給定 XmlReader 回傳的節點也會從這個驗證讀取器回傳，因此過程中不會有資訊遺失。 該讀取器可能會新增未從底層讀取器回傳的新節點（例如，預設屬性及實體參考的子節點）。 對給定 XmlTextReader 值設定的任何屬性也適用於此驗證讀取器。 例如，若所提供的讀取器設定為 WhitespaceHandling.None ，該驗證讀取器同樣會忽略空白空間。
當驗證需要外部文件類型定義（DTD）或結構時，屬性 XmlResolver 會設定 XmlResolver 物件用於解析外部資源。
另請參閱
適用於
XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)
初始化一個新的類別實例 XmlValidatingReader ，並以指定值。
public:
XmlValidatingReader(System::IO::Stream ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);public XmlValidatingReader(System.IO.Stream xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);new System.Xml.XmlValidatingReader : System.IO.Stream * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReaderPublic Sub New (xmlFragment As Stream, fragType As XmlNodeType, context As XmlParserContext)參數
- xmlFragment
- Stream
包含 XML 片段的串流。
- fragType
- XmlNodeType
XML XmlNodeType 片段的 這決定了片段可包含的內容（見下表）。
- context
- XmlParserContext
在 XmlParserContext 其中，XML 片段將被解析。 這包括 XmlNameTable to use、encoding、namespace scope、current xml:lang和 xml:space scope。
例外狀況
fragType 並非下表列出的節點類型之一。
備註
備註
這個 XmlValidatingReader 類別在 .NET Framework 2.0 中已經過時。 你可以透過使用XmlReaderSettings類別和Create方法來建立一個驗證實XmlReader例。 如需詳細資訊，請參閱 XmlReader 參考頁面的＜備註＞一節。
此建構器會將給定字串解析為 XML 的片段。 如果 XML 片段是元素或屬性，你可以繞過根層規則，取得格式良好的 XML 文件。
下表列出了每種不同節點類型的有效值 fragType ，以及讀取器如何解析。
| XmlNodeType | 片段可能包含 |
|---|---|
| 元素 | 任何有效的元素內容（例如，元素、註解、處理指令、cdata、文字及實體參考的任意組合）。 |
| Attribute | 屬性的值（引號內的部分）。 |
| 文件 | 整個 XML 文件的內容;這會強制執行文件層級的規則。 |
讀取器會依以下步驟決定串流的編碼：
檢查 XmlParserContext.Encoding 屬性以確定編碼。
若
Encoding屬性為null，讀取器會檢查串流開頭是否有位元組序標記。若
Encoding屬性為null，且未找到位元組順序標記，讀取器會假設串流以 UTF-8 編碼。
若此讀取器將使用文件類型定義（DTD）進行驗證（即 ValidationType 設定為 ValidationType.DTD 或 ValidationType.Auto）， XmlParserContext 則建構子中指定的必須提供所有必要的 DocumentType 資訊。
備註
無法透過DTD來驗證片段。 DTD 的定義要求完整文件載入以進行驗證。
若此讀取器將使用 XML-Data 縮減（XDR）或 XML 架構定義語言（XSD）來驗證，請使用屬性Schemas指定包含結構XmlParserContext的 （XmlSchemaCollection即不必提供 DocumentType 資訊）。
另請參閱
適用於
XmlValidatingReader(String, XmlNodeType, XmlParserContext)
初始化一個新的類別實例 XmlValidatingReader ，並以指定值。
public:
XmlValidatingReader(System::String ^ xmlFragment, System::Xml::XmlNodeType fragType, System::Xml::XmlParserContext ^ context);public XmlValidatingReader(string xmlFragment, System.Xml.XmlNodeType fragType, System.Xml.XmlParserContext context);new System.Xml.XmlValidatingReader : string * System.Xml.XmlNodeType * System.Xml.XmlParserContext -> System.Xml.XmlValidatingReaderPublic Sub New (xmlFragment As String, fragType As XmlNodeType, context As XmlParserContext)參數
- xmlFragment
- String
包含 XML 片段的字串，要解析。
- fragType
- XmlNodeType
XML XmlNodeType 片段的 這也決定了片段字串可以包含什麼（見下表）。
- context
- XmlParserContext
在 XmlParserContext 其中，XML 片段將被解析。 這包括 NameTable 使用、編碼、命名空間範圍、目前的 xml：lang 以及 xml：space 範圍。
例外狀況
fragType 並非下表列出的節點類型之一。
備註
備註
這個 XmlValidatingReader 類別在 .NET Framework 2.0 中已經過時。 你可以透過使用XmlReaderSettings類別和Create方法來建立一個驗證實XmlReader例。 如需詳細資訊，請參閱 XmlReader 參考頁面的＜備註＞一節。
此建構器會將給定字串解析為 XML 的片段。 如果 XML 片段是元素或屬性，你可以繞過根層規則，取得格式良好的 XML 文件。 此構造子可處理從 返回的 ReadInnerXml字串。
下表列出了每種不同節點類型的有效值 fragType ，以及讀取器如何解析。
| XmlNodeType | 片段可能包含 |
|---|---|
| 元素 | 任何有效的元素內容（例如，元素、註解、處理指令、cdata、文字及實體參考的任意組合）。 |
| Attribute | 屬性的值（引號內的部分）。 |
| 文件 | 整個 XML 文件的內容;這會強制執行文件層級的規則。 |
若此讀取器將使用文件類型定義（DTD）（即 ValidationType 設定為 ValidationType.DTD 或 ValidationType.Auto）來驗證，則 XmlParserContext 建構子中指定的 DocumentType 必須提供所有必要的 DocumentType 資訊。
備註
使用 DTD 無法驗證片段。 DTD 的定義要求完整文件被載入以進行驗證。
如果此讀取器將使用 XML-Data 簡化（XDR）或 XML 架構定義語言（XSD）來驗證，請使用屬性 Schemas 指定包含結構的 （ XmlSchemaCollection 無需 XmlParserContext 提供 DocumentType 資訊）。
