XmlReaderSettings.XmlResolver Свойство

Определение

Пространство имен:

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Исходный код:

XmlReaderSettings.cs

Задает используемый XmlResolver для доступа к внешним документам.

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

Используется 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)