XmlReaderSettings.XmlResolver Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.XmlResolverPublic Property XmlResolver As XmlResolverValeur de propriété
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.