XmlReaderSettings.XmlResolver Propriété

  • Référence

Définition

Espace de noms:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Définit le XmlResolver permettant d'accéder aux documents externes.

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

Valeur de propriété

XmlResolver

XmlResolver permettant d'accéder aux documents externes. Si sa valeur est null, une XmlException est levée lorsque le XmlReader tente d'accéder à une ressource externe. La valeur par défaut est un nouveau XmlUrlResolver sans informations d'identification. À compter de la .NET Framework 4.5.2, ce paramètre a la valeur nullpar défaut .

Exemples

L’exemple suivant crée un XmlReader qui utilise des informations d’identification XmlSecureResolver par défaut.

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

Remarques

Il XmlResolver est utilisé pour localiser et ouvrir un document d’instance XML, ou pour localiser et ouvrir toutes les ressources externes référencées par le document d’instance XML. Cela peut inclure des entités, des DTD ou des schémas. La XmlResolver.Credentials propriété peut être utilisée pour spécifier les informations d’identification requises pour l’authentification réseau.

Important

Étant donné que le XmlResolver conteneur peut contenir des informations sensibles telles que les informations d’identification de l’utilisateur, vous devez être prudent lors de la mise en cache d’objets XmlReaderSettings ou lors du passage de l’objet XmlReaderSettings d’un composant à un autre.

Vous XmlSecureResolver pouvez l’utiliser pour accéder à des documents externes. La XmlSecureResolver classe permet de sécuriser une autre implémentation en XmlResolver encapsulant l’objet XmlResolver et en limitant les ressources auxquelles le sous-jacent XmlResolver a accès.

Les indicateurs de validation ProcessInlineSchema et ProcessSchemaLocation d'un objet XmlReaderSettings ne sont pas activés par défaut. Lorsque ces indicateurs sont activés, la propriété XmlResolver de l'objet XmlReaderSettings est utilisée pour résoudre les emplacements de schéma rencontrés dans le document d'instance dans l'objet XmlReader. Si l’objet XmlResolver est null, les emplacements de schéma ne sont pas résolus même si les ProcessInlineSchema indicateurs de validation et ProcessSchemaLocation les indicateurs de validation sont définis.

Les schémas ajoutés lors de la validation ajoutent de nouveaux types et peuvent changer le résultat de la validation du document en cours de validation. Par conséquent, les schémas externes ne devraient être résolus que s'ils proviennent de sources fiables.

S’applique à

Voir aussi