XmlReaderSettings.XmlResolver Свойство

Определение

Задает XmlResolver, используемый для доступа ко внешним документам.Sets the XmlResolver used to access external documents.

public:
 property System::Xml::XmlResolver ^ XmlResolver {  void set(System::Xml::XmlResolver ^ value); };
public System.Xml.XmlResolver XmlResolver { set; }
member this.XmlResolver : System.Xml.XmlResolver
Public Property XmlResolver As XmlResolver

Значение свойства

XmlResolver, используемый для доступа ко внешним документам.An XmlResolver used to access external documents. Если задано значение null, создается исключение XmlException при попытке XmlReader получить доступ к внешнему ресурсу.If set to null, an XmlException is thrown when the XmlReader tries to access an external resource. По умолчанию используется новый XmlUrlResolver без учетных данных.The default is a new XmlUrlResolver with no credentials. Начиная с .NET Framework 4.5.2, этот параметр имеет значение по умолчанию null.Starting with the .NET Framework 4.5.2, this setting has a default value of null.

Примеры

В следующем примере создается XmlReader, использующий XmlSecureResolver с учетными данными по умолчанию.The following example creates an XmlReader that uses an XmlSecureResolver with default credentials.

// 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.The XmlResolver is used to locate and open an XML instance document, or to locate and open any external resources referenced by the XML instance document. Это могут быть сущности, DTD или схемы.This can include entities, DTD, or schemas. Свойство XmlResolver.Credentials можно использовать для указания любых учетных данных, необходимых для проверки подлинности сети.The XmlResolver.Credentials property can be used to specify any credentials required for network authentication.

Важно!

Поскольку XmlResolver может содержать конфиденциальные сведения, такие как учетные данные пользователя, следует соблюдать осторожность при кэшировании объектов XmlReaderSettings или при передаче объекта XmlReaderSettings из одного компонента в другой.Because the XmlResolver can contain sensitive information such as user credentials, you should be careful when caching XmlReaderSettings objects, or when passing the XmlReaderSettings object from one component to another.

Для доступа к внешним документам можно использовать XmlSecureResolver.An XmlSecureResolver can be used to access external documents. Класс XmlSecureResolver помогает защитить другую реализацию XmlResolver путем упаковки объекта XmlResolver и ограничивает ресурсы, к которым имеет доступ базовый XmlResolver.The XmlSecureResolver class helps to secure another implementation of XmlResolver by wrapping the XmlResolver object and restricting the resources that the underlying XmlResolver has access to.

Флаги проверки ProcessInlineSchema и ProcessSchemaLocation объекта XmlReaderSettings по умолчанию не установлены.The ProcessInlineSchema and ProcessSchemaLocation validation flags of an XmlReaderSettings object are not set by default. Если эти флаги установлены, для разрешения расположения схем, обнаруженных в экземпляре документа в объекте XmlResolver, используется арбитр XmlReaderSettings объекта XmlReader.When these flags are set, the XmlResolver of the XmlReaderSettings object is used to resolve schema locations encountered in the instance document in the XmlReader. Если XmlResolver объект null, расположения схем не разрешаются, даже если установлены флаги проверки ProcessInlineSchema и ProcessSchemaLocation.If the XmlResolver object is null, schema locations are not resolved even if the ProcessInlineSchema and ProcessSchemaLocation validation flags are set.

Схемы, добавленные во время проверки, добавляют новые типы и могут изменить результат проверки документа.Schemas added during validation add new types and can change the validation outcome of the document being validated. Поэтому следует разрешать только внешние схемы из доверенных источников.As a result, external schemas should only be resolved from trusted sources.

Применяется к

Дополнительно