XmlValidatingReader 构造函数

定义

命名空间:

System.Xml

程序集:

netstandard.dll, System.Xml.ReaderWriter.dll

初始化 XmlValidatingReader 类的新实例。

重载

名称	说明
XmlValidatingReader(XmlReader)	初始化类的新实例，该实例 XmlValidatingReader 验证从给定 XmlReader返回的内容。
XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)	使用指定的值初始化类的新实例 XmlValidatingReader 。
XmlValidatingReader(String, XmlNodeType, XmlParserContext)	使用指定的值初始化类的新实例 XmlValidatingReader 。

XmlValidatingReader(XmlReader)

Source:

XmlValidatingReader.cs

初始化类的新实例，该实例 XmlValidatingReader 验证从给定 XmlReader返回的内容。

public:
 XmlValidatingReader(System::Xml::XmlReader ^ reader);

public XmlValidatingReader(System.Xml.XmlReader reader);

new System.Xml.XmlValidatingReader : System.Xml.XmlReader -> System.Xml.XmlValidatingReader

Public Sub New (reader As XmlReader)

参数

reader

XmlReader

XmlReader验证时要从中读取。 当前实现仅 XmlTextReader支持 。

例外

ArgumentException

指定的读取器不是一个 XmlTextReader。

注解

注释

该 XmlValidatingReader 类在 .NET Framework 2.0 中已过时。 可以使用类和Create方法创建验证XmlReader实例XmlReaderSettings。 有关详细信息，请参阅 XmlReader 引用页的“备注”部分。

从给定 XmlReader 返回的所有节点也从此验证读取器返回，因此在此过程中不会丢失任何信息。 此读取器可能会添加未从基础读取器返回的新节点（例如，默认属性和实体引用的子级）。 给定 XmlTextReader 上设置的任何属性也适用于此验证读取器。 例如，如果提供的读取器设置了 WhitespaceHandling.None，则此验证读取器也会忽略空格。

当需要外部文档类型定义（DTDs）或架构进行验证时，属性 XmlResolver 将设置 XmlResolver 用于解析外部资源的对象。

另请参阅

• XmlTextReader
• XmlReader

XmlValidatingReader(Stream, XmlNodeType, XmlParserContext)

Source:

XmlValidatingReader.cs

使用指定的值初始化类的新实例 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.XmlValidatingReader

Public Sub New (xmlFragment As Stream, fragType As XmlNodeType, context As XmlParserContext)

参数

xmlFragment

Stream

包含要分析的 XML 片段的流。

fragType

XmlNodeType

XmlNodeType XML 片段。 这将确定片段可以包含的内容（请参阅下表）。

context

XmlParserContext

XmlParserContext要分析 XML 片段的其中。 这包括 XmlNameTable 要使用的编码、命名空间范围、当前 xml:lang和 xml:space 作用域。

例外

XmlException

fragType 不是下表中列出的节点类型之一。

注解

注释

该 XmlValidatingReader 类在 .NET Framework 2.0 中已过时。 可以使用类和Create方法创建验证XmlReader实例XmlReaderSettings。 有关详细信息，请参阅 XmlReader 引用页的“备注”部分。

此构造函数将给定字符串分析为 XML 片段。 如果 XML 片段是元素或属性，则可以绕过格式良好的 XML 文档的根级别规则。

下表列出了读取器分析每个不同节点类型的有效值 fragType 及其方式。

XmlNodeType	片段可能包含
元素	任何有效的元素内容（例如，元素、注释、处理指令、cdata、文本和实体引用的任意组合）。
Attribute	特性的值（引号内的部件）。
文档	整个 XML 文档的内容;这将强制实施文档级别规则。

读取器使用以下步骤来确定流的编码：

1. 检查 XmlParserContext.Encoding 属性以确定编码。

2. Encoding如果该属性为null，读取器将检查流开头的字节顺序标记。

3. Encoding如果属性为null，并且找不到字节顺序标记，则读取器假定流在 UTF-8 中编码。

如果此读取器将使用文档类型定义（DTD）（即 ValidationType 设置为 ValidationType.DTD 或 ValidationType.Auto）进行验证， XmlParserContext 则构造函数中指定的必须提供所有必要的 DocumentType 信息。

注释

无法使用 DTD 验证片段。 根据定义，DTD 需要加载整个文档才能进行验证。

如果此读取器将使用 XML-Data Reduced （XDR） 或 XML 架构定义语言 （XSD） 架构进行验证，请使用 Schemas 该属性指定 XmlSchemaCollection 包含架构（即 XmlParserContext 不需要提供 DocumentType 信息）的属性。

另请参阅

• XmlReader

XmlValidatingReader(String, XmlNodeType, XmlParserContext)

Source:

XmlValidatingReader.cs

使用指定的值初始化类的新实例 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.XmlValidatingReader

Public Sub New (xmlFragment As String, fragType As XmlNodeType, context As XmlParserContext)

参数

xmlFragment

String

包含要分析的 XML 片段的字符串。

fragType

XmlNodeType

XmlNodeType XML 片段。 这还确定片段字符串可以包含的内容（请参阅下表）。

context

XmlParserContext

XmlParserContext要分析 XML 片段的其中。 这包括 NameTable 要使用的编码、命名空间范围、当前 xml：lang 和 xml：space 范围。

例外

XmlException

fragType 不是下表中列出的节点类型之一。

注解

注释

该 XmlValidatingReader 类在 .NET Framework 2.0 中已过时。 可以使用类和Create方法创建验证XmlReader实例XmlReaderSettings。 有关详细信息，请参阅 XmlReader 引用页的“备注”部分。

此构造函数将给定字符串分析为 XML 片段。 如果 XML 片段是元素或属性，则可以绕过格式良好的 XML 文档的根级别规则。 此构造函数可以处理从 ReadInnerXml中返回的字符串。

下表列出了读取器分析每个不同节点类型的有效值 fragType 及其方式。

XmlNodeType	片段可能包含
元素	任何有效的元素内容（例如，元素、注释、处理指令、cdata、文本和实体引用的任意组合）。
Attribute	特性的值（引号内的部件）。
文档	整个 XML 文档的内容;这将强制实施文档级别规则。

如果此读取者将使用文档类型定义（DTD）（即 ValidationType 设置为 ValidationType.DTD 或 ValidationType.Auto）进行验证， XmlParserContext 则构造函数中指定的必须提供所有必要的 DocumentType 信息。

注释

无法使用 DTD 验证片段。 根据定义，DTD 要求加载整个文档进行验证。

如果此读取器将使用 XML-Data Reduced （XDR） 或 XML 架构定义语言 （XSD） 架构进行验证，请使用 Schemas 该属性指定 XmlSchemaCollection 包含架构（ XmlParserContext 不需要提供 DocumentType 信息）的属性。

另请参阅

• XmlReader