XmlReaderSettings 類別

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

來源:

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 文件和資料