XmlReaderSettings 類別

  • 參考

定義

命名空間:
System.Xml
組件:
System.Xml.ReaderWriter.dll
組件:
System.Xml.dll
組件:
netstandard.dll
Source:
XmlReaderSettings.cs
Source:
XmlReaderSettings.cs
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 類別的新執行個體。
XmlReaderSettings(XmlResolver)
已淘汰.

初始化 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

發生於讀取器遇到驗證錯誤時。

適用於

另請參閱