XmlReaderSettings 类

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

Source:

XmlReaderSettings.cs

指定在由 XmlReader 方法创建的 Create 对象上支持的一组功能。

public ref class XmlReaderSettings sealed

public sealed class XmlReaderSettings

type XmlReaderSettings = class

Public NotInheritable Class XmlReaderSettings

继承

Object

XmlReaderSettings

示例

以下示例创建一个 XmlReader ，它使用 XmlUrlResolver 具有所需凭据的 。

// Create an XmlUrlResolver with the credentials necessary to access the Web server.
var resolver = new XmlUrlResolver();
var myCred = new NetworkCredential(UserName, SecurelyStoredPassword, Domain);
resolver.Credentials = myCred;

var settings = new XmlReaderSettings();
settings.XmlResolver = resolver;

// Create the reader.
XmlReader reader = XmlReader.Create("http://serverName/data/books.xml", settings);

' Create an XmlUrlResolver with the credentials necessary to access the Web server.
Dim resolver As New XmlUrlResolver()
Dim myCred As System.Net.NetworkCredential
myCred = New System.Net.NetworkCredential(UserName, SecurelyStoredPassword, Domain)
resolver.Credentials = myCred

Dim settings As New XmlReaderSettings()
settings.XmlResolver = resolver

' Create the reader.
Dim reader As XmlReader = XmlReader.Create("http://serverName/data/books.xml", settings)

注解

有关此 API 的详细信息，请参阅 XmlReaderSettings 的补充 API 备注。

构造函数

XmlReaderSettings()

初始化 XmlReaderSettings 类的新实例。

属性

Async	获取或设置是否可对特定 XmlReader 实例使用异步 XmlReader 方法。
CheckCharacters	获取或设置一个值，该值指示是否进行字符检查。
CloseInput	获取或设置一个值，该值指示当读取器关闭时，是否应关闭基础流或 TextReader。
ConformanceLevel	获取或设置 XmlReader 将遵循的一致性级别。
DtdProcessing	获取或设置确定 DTD 的处理的值。
IgnoreComments	获取或设置一个值，该值指示是否忽略注释。
IgnoreProcessingInstructions	获取或设置一个值，该值指示是否忽略处理指令。
IgnoreWhitespace	获取或设置一个值，该值指示是否忽略无关紧要的空白区域。
LineNumberOffset	获取或设置 XmlReader 对象的行号偏移量。
LinePositionOffset	获取或设置 XmlReader 对象的行位置偏移量。
MaxCharactersFromEntities	获取或设置一个值，该值指示文档中允许扩展实体产生的最大字符数。
MaxCharactersInDocument	获取或设置一个值，该值指明 XML 文档中所允许的最大字符数。 零 (0) 值表示对 XML 文档的大小没有限制。 非零值指定最大大小（以字符数计）。
NameTable	获取或设置用于原子化字符串比较的 XmlNameTable。
ProhibitDtd	已过时. 获取或设置一个值，该值指示是否禁用文档类型定义 (DTD) 处理。 此属性已过时。 请改用 DtdProcessing。
Schemas	获取或设置在执行架构验证时使用的 XmlSchemaSet。
ValidationFlags	获取或设置一个指示架构验证设置的值。 此设置应用于验证架构的 XmlReader 对象（ValidationType 属性设置为 ValidationType.Schema）。
ValidationType	获取或设置一个值，该值指示 XmlReader 在读取时是否执行验证或类型分配。
XmlResolver	设置用来访问外部文档的 XmlResolver。

方法

Clone()	创建 XmlReaderSettings 实例的副本。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Reset()	将设置类的成员重置为各自的默认值。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

事件

ValidationEventHandler

在读取器遇到验证错误时发生。

另请参阅

• XML 文档和数据