XmlReaderSettings.XmlResolver XmlReaderSettings.XmlResolver XmlReaderSettings.XmlResolver XmlReaderSettings.XmlResolver Property

정의

외부 문서에 액세스하는 데 사용할 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이 throw됩니다.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 개체의 ProcessSchemaLocationXmlReaderSettings 유효성 검사 플래그는 기본적으로 설정되지 않습니다.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, 스키마 위치는 확인 되지 않습니다 경우에 합니다 ProcessInlineSchemaProcessSchemaLocation 유효성 검사 플래그를 설정 합니다.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.

적용 대상

추가 정보