XmlReaderSettings.XmlResolver Propiedad

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Establece el objeto XmlResolver utilizado para obtener acceso a documentos externos.

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 de propiedad

XmlResolver

Objeto XmlResolver utilizado para tener acceso a documentos externos. Si se establece en null, se produce una excepción XmlException cuando el objeto XmlReader intenta obtener acceso a un recurso externo. El valor predeterminado es un nuevo objeto XmlUrlResolver sin credenciales. A partir de la .NET Framework 4.5.2, esta configuración tiene un valor predeterminado de null.

Ejemplos

En el ejemplo siguiente se crea un XmlReader objeto que usa un XmlSecureResolver objeto con credenciales predeterminadas.

// 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)

Comentarios

XmlResolver se usa para buscar y abrir un documento de instancia XML, o para buscar y abrir los recursos externos a los que hace referencia el documento de instancia XML. Esto puede incluir entidades, DTD o esquemas. La XmlResolver.Credentials propiedad se puede usar para especificar las credenciales necesarias para la autenticación de red.

Importante

XmlResolver Dado que puede contener información confidencial, como las credenciales de usuario, debe tener cuidado al almacenar en caché XmlReaderSettings objetos o al pasar el XmlReaderSettings objeto de un componente a otro.

Se XmlSecureResolver puede usar para acceder a documentos externos. La XmlSecureResolver clase ayuda a proteger otra implementación de XmlResolver ajustando el XmlResolver objeto y restringiendo los recursos a los que tiene acceso el subyacente XmlResolver .

Las marcas de validación ProcessInlineSchema y ProcessSchemaLocation de un objeto XmlReaderSettings no están establecidos de manera predeterminada. Cuando se establecen estas marcas, se utiliza el XmlResolver del objeto XmlReaderSettings para resolver las ubicaciones de esquemas que se encuentra en el documento de la instancia de XmlReader. Si el XmlResolver objeto es null, las ubicaciones de esquema no se resuelven aunque se establezcan las ProcessInlineSchema marcas de validación y ProcessSchemaLocation .

Los esquemas agregados durante la validación agregan nuevos tipos y pueden cambiar el resultado de la validación del documento. Como consecuencia, los esquemas externos solo se deberían resolver desde orígenes de confianza.

Consulte también

• XmlReader
• Create(String)