System.Xml.XmlValidatingReader 类
方法描述
表示提供文档类型定义 (DTD)、XML 数据简化 (XDR) 架构和 XML 架构定义语言 (XSD) 验证的读取器。
语法定义(C# System.Xml.XmlValidatingReader 类 的用法)
[ObsoleteAttribute("Use XmlReader created by XmlReader.Create() method using appropriate XmlReaderSettings instead. http://go.microsoft.com/fwlink/?linkid=14202")] [PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")] public class XmlValidatingReader : XmlReader, IXmlLineInfo, IXmlNamespaceResolver
构造函数
构造函数名称 | 构造函数描述 |
---|---|
XmlValidatingReader(XmlReader) | 初始化 XmlValidatingReader 类的新实例,该类验证从给定的 XmlReader 返回的内容。 |
XmlValidatingReader(Stream, XmlNodeType, XmlParserContext) | 用指定的值初始化 XmlValidatingReader 类的新实例。 |
XmlValidatingReader(String, XmlNodeType, XmlParserContext) | 用指定的值初始化 XmlValidatingReader 类的新实例。 |
成员/方法
方法名称 | 方法描述 |
---|---|
Close | 将 ReadState 更改为 Closed。 (重写 XmlReader.Close()。) |
Dispose(Boolean) | 释放由 XmlReader 占用的非托管资源,还可以另外再释放托管资源。 (继承自 XmlReader。) |
Equals(Object) | 确定指定的 Object 是否等于当前的 Object。 (继承自 Object。) |
Finalize | 允许对象在“垃圾回收”回收之前尝试释放资源并执行其他清理操作。 (继承自 Object。) |
GetAttribute(Int32) | 获取具有指定索引的特性的值。 (重写 XmlReader.GetAttribute(Int32)。) |
GetAttribute(String) | 获取具有指定名称的特性的值。 (重写 XmlReader.GetAttribute(String)。) |
GetAttribute(String, String) | 获取具有指定的本地名称和命名空间统一资源标识符 (URI) 的特性的值。 (重写 XmlReader.GetAttribute(String, String)。) |
GetHashCode | 用作特定类型的哈希函数。 (继承自 Object。) |
GetType | 获取当前实例的 Type。 (继承自 Object。) |
HasLineInfo | 获取一个值,该值指示该类是否可返回行信息。 |
IsStartElement() | 调用 MoveToContent 并测试当前内容节点是否是开始标记或空元素标记。 (继承自 XmlReader。) |
IsStartElement(String) | 调用 MoveToContent 并测试当前内容节点是否是开始标记或空元素标记,以及所找到元素的 Name 属性是否与给定的参数匹配。 (继承自 XmlReader。) |
IsStartElement(String, String) | 调用 MoveToContent 并测试当前内容节点是否是开始标记或空元素标记,以及所找到元素的 LocalName 和 NamespaceURI 属性是否与给定的字符串匹配。 (继承自 XmlReader。) |
LookupNamespace | 解析当前元素的范围内的命名空间前缀。 (重写 XmlReader.LookupNamespace(String)。) |
MemberwiseClone | 创建当前 Object 的浅表副本。 (继承自 Object。) |
MoveToAttribute(Int32) | 移动到具有指定索引的特性。 (重写 XmlReader.MoveToAttribute(Int32)。) |
MoveToAttribute(String) | 移动到具有指定名称的特性。 (重写 XmlReader.MoveToAttribute(String)。) |
MoveToAttribute(String, String) | 移动到具有指定的本地名称和命名空间统一资源标识符 (URI) 的特性。 (重写 XmlReader.MoveToAttribute(String, String)。) |
MoveToContent | 检查当前节点是否是内容(非空白文本、CDATA、Element、EndElement、EntityReference 或 EndEntity)节点。 如果此节点不是内容节点,则读取器向前跳至下一个内容节点或文件结尾。 它跳过以下类型的节点:ProcessingInstruction、DocumentType、Comment、Whitespace 或 SignificantWhitespace。 (继承自 XmlReader。) |
MoveToElement | 移动到包含当前特性节点的元素。 (重写 XmlReader.MoveToElement()。) |
MoveToFirstAttribute | 移动到第一个特性。 (重写 XmlReader.MoveToFirstAttribute()。) |
MoveToNextAttribute | 移动到下一个特性。 (重写 XmlReader.MoveToNextAttribute()。) |
Read | 从流中读取下一个节点。 (重写 XmlReader.Read()。) |
ReadAttributeValue | 将特性值分析为一个或多个 Text、EntityReference 或 EndEntity 节点。 (重写 XmlReader.ReadAttributeValue()。) |
ReadContentAs | 将内容作为指定类型的对象读取。 (继承自 XmlReader。) |
ReadContentAsBase64 | 读取内容并返回 Base64 解码的二进制字节。 (重写 XmlReader.ReadContentAsBase64(Byte[], Int32, Int32)。) |
ReadContentAsBinHex | 读取内容并返回 BinHex 解码的二进制字节。 (重写 XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32)。) |
ReadContentAsBoolean | 将当前位置的文本内容作为 Boolean 读取。 (继承自 XmlReader。) |
ReadContentAsDateTime | 将当前位置的文本内容作为 DateTime 对象读取。 (继承自 XmlReader。) |
ReadContentAsDecimal | 将当前位置的文本内容作为 Decimal 对象读取。 (继承自 XmlReader。) |
ReadContentAsDouble | 将当前位置的文本内容作为双精度浮点数读取。 (继承自 XmlReader。) |
ReadContentAsFloat | 将当前位置的文本内容作为单精度浮点数读取。 (继承自 XmlReader。) |
ReadContentAsInt | 将当前位置的文本内容作为 32 位有符号整数读取。 (继承自 XmlReader。) |
ReadContentAsLong | 将当前位置的文本内容作为 64 位有符号整数读取。 (继承自 XmlReader。) |
ReadContentAsObject | 将当前位置的文本内容作为 Object 读取。 (继承自 XmlReader。) |
ReadContentAsString | 将当前位置的文本内容作为 String 对象读取。 (继承自 XmlReader。) |
ReadElementContentAs(Type, IXmlNamespaceResolver) | 将元素内容作为请求类型读取。 (继承自 XmlReader。) |
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String) | 检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配,然后将元素内容作为请求类型读取。 (继承自 XmlReader。) |
ReadElementContentAsBase64 | 读取元素并对 Base64 内容进行解码。 (重写 XmlReader.ReadElementContentAsBase64(Byte[], Int32, Int32)。) |
ReadElementContentAsBinHex | 读取元素并对 BinHex 内容进行解码。 (重写 XmlReader.ReadElementContentAsBinHex(Byte[], Int32, Int32)。) |
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。) |
ReadElementContentAsString() | 读取当前元素并将内容作为 String 对象返回。 (继承自 XmlReader。) |
ReadElementContentAsString(String, String) | 检查指定的本地名称和命名空间 URI 与当前元素的本地名称和命名空间 URI 是否匹配,然后读取当前元素,并将内容作为 String 对象返回。 (继承自 XmlReader。) |
ReadElementString() | 读取纯文本元素。 (继承自 XmlReader。) |
ReadElementString(String) | 在读取纯文本元素之前,检查所找到元素的 Name 属性是否与给定的字符串匹配。 (继承自 XmlReader。) |
ReadElementString(String, String) | 在读取纯文本元素之前,检查所找到元素的 LocalName 和 NamespaceURI 属性是否与给定的字符串匹配。 (继承自 XmlReader。) |
ReadEndElement | 检查当前内容节点是否为结束标记并将读取器推进到下一个节点。 (继承自 XmlReader。) |
ReadInnerXml | 当在派生类中被重写时,将所有内容(包括标记)当做字符串读取。 (继承自 XmlReader。) |
ReadOuterXml | 当在派生类中被重写时,读取表示该节点和所有它的子级的内容(包括标记)。 (继承自 XmlReader。) |
ReadStartElement() | 检查当前节点是否为元素并将读取器推进到下一个节点。 (继承自 XmlReader。) |
ReadStartElement(String) | 检查当前内容节点是否为具有给定 Name 的元素并将读取器推进到下一个节点。 (继承自 XmlReader。) |
ReadStartElement(String, String) | 检查当前内容节点是否为具有给定 LocalName 和 NamespaceURI 的元素并将读取器推进到下一个节点。 (继承自 XmlReader。) |
ReadString | 将元素或文本节点的内容读取为一个字符串。 (重写 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 | 读取嵌入在 XML 文档中的大量文本流。 (继承自 XmlReader。) |
ResolveEntity | 解析 EntityReference 节点的实体引用。 (重写 XmlReader.ResolveEntity()。) |
Skip | 跳过当前节点的子级。 (继承自 XmlReader。) |
ToString | 返回表示当前对象的字符串。 (继承自 Object。) |
提示和注释
XmlValidatingReader 实现 XmlReader 类并提供对数据验证的支持。 使用 Schemas 属性使读取器使用缓存在 XmlSchemaCollection 中的架构文件进行验证。 ValidationType 属性指定读取器应该执行哪种类型的验证。 将该属性设置为 ValidationType.None 会创建一个非验证读取器。
XmlValidatingReader 在发生 XML 分析错误时引发 XmlException。 引发异常后,读取器的状态不可预知。 例如,报告的节点类型可能不同于当前节点的实际节点类型。 使用 ReadState 属性检查读取器是否处于错误状态。
注意
XmlValidatingReader 类在 .NET Framework 2.0 版中已过时。 您可以使用 XmlReaderSettings 类和 Create 方法创建一个验证 XmlReader 实例。 有关更多信息,请参见 使用 XmlReader 验证 XML 数据。
对继承者的说明
该类有继承需求。 要从 XmlValidatingReader 继承,需要完全信任。 有关更多信息,请参见 继承需求。
System.Xml.XmlValidatingReader 类例子
线程安全
此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。
版本信息
.NET Framework 受以下版本支持:1.1、1.0 在 4 中过时(编译器警告) 在 3.5 中过时(编译器警告) 在 3.5 SP1 中过时(编译器警告) 在 3.0 中过时(编译器警告) 在 3.0 SP1 中过时(编译器警告) 在 3.0 SP2 中过时(编译器警告) 在 2.0 中过时(编译器警告) 在 2.0 SP1 中过时(编译器警告) 在 2.0 SP2 中过时(编译器警告) .NET Framework Client Profile 在 4 中过时(编译器警告) 在 3.5 SP1 中过时(编译器警告)
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。