XmlValidatingReader 类

参考

定义

命名空间:: System.Xml

程序集:: System.Xml.ReaderWriter.dll

程序集:: System.Xml.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

注意

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 数据简化 (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 引发 XmlException XML 分析错误。引发异常后，读取器的状态不可预测。例如，报告的节点类型可能与当前节点的实际节点类型不同。使用 ReadState 属性检查读取器是否处于错误状态。

备注

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

继承者说明

此类具有继承需求。需要完全信任才能从 XmlValidatingReader中继承。

构造函数

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

属性

AttributeCount	获取当前节点上的属性数目。
BaseURI	获取当前节点的基 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	获取当前节点的限定名称。
Namespaces	获取或设置一个值，该值指示是否进行命名空间支持。
NamespaceURI	对于读取器定位到的节点，按照万维网联合会 (W3C) 命名空间规范的定义，获取该节点的命名空间统一资源标识符 (URI)。
NameTable	获取与此实现关联的 XmlNameTable。
NodeType	获取当前节点的类型。
Prefix	获取与当前节点关联的命名空间前缀。
QuoteChar	获取用于括起属性节点的值的引号字符。
Reader	获取用于构造此 `XmlValidatingReader` 的 XmlReader。
ReadState	获取读取器的状态。
SchemaInfo	获取作为架构验证结果分配给当前节点的架构信息。 (继承自 XmlReader)
Schemas	获取一个用于验证的 XmlSchemaCollection。
SchemaType	获取架构类型对象。
Settings	获取用于创建此 XmlValidatingReader 实例的 XmlReaderSettings 对象。
Settings	获取用于创建此 XmlReader 实例的 XmlReaderSettings 对象。 (继承自 XmlReader)
ValidationType	获取或设置一个值，该值指示要执行的验证的类型。
Value	获取当前节点的文本值。
ValueType	获取当前节点的公共语言运行时 (CLR) 类型。 (继承自 XmlReader)
XmlLang	获取当前 `xml:lang` 范围。
XmlResolver	设置用于解析外部文档类型定义 (DTD) 和架构位置引用的 XmlResolver。 `XmlResolver` 用于处理 XML 架构定义语言 (XSD) 架构中找到的任何 import 或 include 元素。
XmlSpace	获取当前 `xml:space` 范围。

方法

Close()	将 ReadState 更改为“已关闭”。
Dispose()	释放 XmlReader 类的当前实例所使用的所有资源。 (继承自 XmlReader)
Dispose(Boolean)	释放由 XmlReader 占用的非托管资源，还可以另外再释放托管资源。 (继承自 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 与当前元素的本地名称和命名空间 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 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 Boolean 对象返回。 (继承自 XmlReader)
ReadElementContentAsDateTime()	读取当前元素并将内容作为 DateTime 对象返回。 (继承自 XmlReader)
ReadElementContentAsDateTime(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 DateTime 对象返回。 (继承自 XmlReader)
ReadElementContentAsDecimal()	读取当前元素并将内容作为 Decimal 对象返回。 (继承自 XmlReader)
ReadElementContentAsDecimal(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 Decimal 对象返回。 (继承自 XmlReader)
ReadElementContentAsDouble()	读取当前元素并将内容作为双精度浮点数返回。 (继承自 XmlReader)
ReadElementContentAsDouble(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为双精度浮点数返回。 (继承自 XmlReader)
ReadElementContentAsFloat()	读取当前元素并将内容作为单精度浮点数返回。 (继承自 XmlReader)
ReadElementContentAsFloat(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为单精度浮点数返回。 (继承自 XmlReader)
ReadElementContentAsInt()	读取当前元素并将内容作为 32 位有符号整数返回。 (继承自 XmlReader)
ReadElementContentAsInt(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 32 位有符号整数返回。 (继承自 XmlReader)
ReadElementContentAsLong()	读取当前元素并将内容作为 64 位有符号整数返回。 (继承自 XmlReader)
ReadElementContentAsLong(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 64 位有符号整数返回。 (继承自 XmlReader)
ReadElementContentAsObject()	读取当前元素并将内容作为 Object 返回。 (继承自 XmlReader)
ReadElementContentAsObject(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配，然后读取当前元素，并将内容作为 Object 返回。 (继承自 XmlReader)
ReadElementContentAsObjectAsync()	异步读取当前元素并将内容作为 Object 返回。 (继承自 XmlReader)
ReadElementContentAsString()	读取当前元素并将内容作为 String 对象返回。 (继承自 XmlReader)
ReadElementContentAsString(String, String)	检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 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) 类型的公共语言运行时类型。
ReadValueChunk(Char[], Int32, Int32)	读取嵌入在 XML 文档中的大量文本流。 (继承自 XmlReader)
ReadValueChunkAsync(Char[], Int32, Int32)	异步读取嵌入在 XML 文档中的大量文本流。 (继承自 XmlReader)
ResolveEntity()	解析 `EntityReference` 节点的实体引用。
Skip()	跳过当前节点的子级。 (继承自 XmlReader)
SkipAsync()	异步跳过当前节点的子级。 (继承自 XmlReader)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

事件

ValidationEventHandler

设置事件处理程序以接收有关文档类型定义 (DTD)、XML 数据简化 (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