XmlReaderSettings.XmlResolver 屬性

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.dll

組件:

netstandard.dll

設定用來存取外部文件的 XmlResolver。

public:
 property System::Xml::XmlResolver ^ XmlResolver {  void set(System::Xml::XmlResolver ^ value); };

public System.Xml.XmlResolver? XmlResolver { set; }

public System.Xml.XmlResolver XmlResolver { set; }

member this.XmlResolver : System.Xml.XmlResolver

Public Property XmlResolver As XmlResolver

屬性值

XmlResolver

XmlResolver，用於存取外部文件。 如果設為 null，則在 XmlException 嘗試存取外部資源時會擲回 XmlReader。 預設為沒有認證的新 XmlUrlResolver。 從 .NET Framework 4.5.2 開始，此設定的預設值 null 為 。

範例

下列範例會 XmlReader 建立使用 XmlSecureResolver 具有預設認證的 。

// Create an XmlSecureResolver with default credentials.
XmlSecureResolver myResolver = new XmlSecureResolver(new XmlUrlResolver(), "http://serverName/data/");
myResolver.Credentials = CredentialCache.DefaultCredentials;

XmlReaderSettings settings = new XmlReaderSettings();
settings.XmlResolver = myResolver;

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

' Create an XmlSecureResolver with default credentials.
Dim myResolver As New XmlSecureResolver(New XmlUrlResolver(), "http://serverName/data/")
myResolver.Credentials = CredentialCache.DefaultCredentials

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

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

備註

XmlResolver用來尋找和開啟 XML 實例檔，或尋找並開啟 XML 實例檔所參考的任何外部資源。 這可以包含實體、DTD 或架構。 屬性 XmlResolver.Credentials 可用來指定網路驗證所需的任何認證。

重要

XmlResolver因為 可以包含敏感性資訊，例如使用者認證，所以快取 XmlReaderSettings 物件時，或將物件從某個元件傳遞 XmlReaderSettings 至另一個元件時，應該小心。

XmlSecureResolver可用來存取外部檔。 類別 XmlSecureResolver 可藉由包裝 XmlResolver 物件及限制基礎 XmlResolver 可存取的資源，協助保護 的另一個 實 XmlResolver 作。

依預設，不會設定 ProcessInlineSchema 物件的 ProcessSchemaLocation 及 XmlReaderSettings 驗證旗標。 當設定這些旗標時，XmlResolver 物件的 XmlReaderSettings 可用於解析在 XmlReader 的執行個體文件中發現的結構描述位置。 XmlResolver如果物件是 null ，即使 ProcessInlineSchema 已設定 和 ProcessSchemaLocation 驗證旗標，架構位置也不會解析。

驗證期間加入的結構描述會加入新型別，並可變更要驗證之物件的驗證結果。 因此，外部結構描述應僅從受信任的來源解析。

另請參閱

• XmlReader
• Create(String)