XmlReaderSettings.XmlResolver Propriedade

Definição

Define o XmlResolver usado para acessar documentos externos.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; }
public System.Xml.XmlResolver XmlResolver { set; }
member this.XmlResolver : System.Xml.XmlResolver
Public Property XmlResolver As XmlResolver

Valor da propriedade

XmlResolver

Um XmlResolver usado para acessar documentos externos.An XmlResolver used to access external documents. Se for definido como null, uma XmlException será gerada quando o XmlReader tentar acessar um recurso externo.If set to null, an XmlException is thrown when the XmlReader tries to access an external resource. O padrão é um novo XmlUrlResolver sem credenciais.The default is a new XmlUrlResolver with no credentials. A partir do .NET Framework 4.5.2, essa configuração tem o valor padrão null.Starting with the .NET Framework 4.5.2, this setting has a default value of null.

Exemplos

O exemplo a seguir cria um XmlReader que usa um XmlSecureResolver com credenciais padrão.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)

Comentários

O XmlResolver é usado para localizar e abrir um documento de instância XML, ou para localizar e abrir quaisquer recursos externos referenciados pelo documento da instância 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. Isso pode incluir entidades, DTD ou esquemas.This can include entities, DTD, or schemas. A XmlResolver.Credentials propriedade pode ser usada para especificar as credenciais necessárias para a autenticação de rede.The XmlResolver.Credentials property can be used to specify any credentials required for network authentication.

Importante

Como o XmlResolver pode conter informações confidenciais, como credenciais de usuário, você deve ter cuidado ao armazenar objetos em cache XmlReaderSettings ou ao passar o XmlReaderSettings objeto de um componente para outro.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.

Um XmlSecureResolver pode ser usado para acessar documentos externos.An XmlSecureResolver can be used to access external documents. A XmlSecureResolver classe ajuda a proteger outra implementação do XmlResolver , encapsulando o XmlResolver objeto e restringindo os recursos aos quais o subjacente XmlResolver tem acesso.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.

Os sinalizadores de validação de ProcessInlineSchema e de ProcessSchemaLocation de um objeto de XmlReaderSettings não são definidos por padrão.The ProcessInlineSchema and ProcessSchemaLocation validation flags of an XmlReaderSettings object are not set by default. Quando esses sinalizadores são definidos, XmlResolver do objeto de XmlReaderSettings é usado para resolver os locais de esquema encontrados no documento de instância em 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. Se o XmlResolver objeto for null , os locais de esquema não serão resolvidos, mesmo se os ProcessInlineSchema ProcessSchemaLocation sinalizadores de validação e estiverem definidos.If the XmlResolver object is null, schema locations are not resolved even if the ProcessInlineSchema and ProcessSchemaLocation validation flags are set.

Os esquemas adicionados durante a validação adicionar novos tipos e podem alterar o resultado de validação de documento que está sendo validada.Schemas added during validation add new types and can change the validation outcome of the document being validated. Como resultado, os esquemas externos só devem ser resolvidos de fontes confiáveis.As a result, external schemas should only be resolved from trusted sources.

Aplica-se a

Confira também