XmlReaderSettings.XmlResolver, propriété
Assembly : System.Xml (dans system.xml.dll)
/** @property */ public void set_XmlResolver (XmlResolver value)
public function set XmlResolver (value : XmlResolver)
Valeur de la propriété
XmlResolver permettant d'accéder aux documents externes. S'il a la valeur référence Null (Nothing en Visual Basic), 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.XmlResolver permet de localiser et d'ouvrir une instance de document XML, ou de localiser et d'ouvrir toutes les ressources externes référencées par l'instance de document XML. Cela peut inclure des entités, DTD ou schémas. La propriété XmlResolver.Credentials peut servir à spécifier des informations d'identification requises pour l'authentification de réseau.
Remarque de sécurité |
|---|
| Puisque le XmlResolver peut contenir des informations personnelles telles que les informations d'identification de l'utilisateur, vous devez être prudent lorsque vous mettez en cache des objets XmlReaderSettings ou lorsque vous passez l'objet XmlReaderSettings d'un composant à un autre. XmlSecureResolver peut servir à accéder à des documents externes. La classe XmlSecureResolver aide à sécuriser une autre implémentation de XmlResolver en encapsulant l'objet XmlResolver et en restreignant les ressources auxquelles a accès le XmlResolver sous-jacent. Pour plus d'informations, consultez Procédure : utilisation de la classe XmlSecureResolver. Les indicateurs de validation ProcessInlineSchema et ProcessSchemaLocation d'un objet XmlReaderSettings ne sont pas définis par défaut. Lorsque ces indicateurs sont définis, le XmlResolver de l'objet XmlReaderSettings permet de résoudre les emplacements de schéma trouvés dans le document d'instance de XmlReader. Si l'objet XmlResolver est référence Null (Nothing en Visual Basic), les emplacements de schéma ne sont pas résolus même si les indicateurs de validation ProcessInlineSchema et ProcessSchemaLocation 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. En conséquence, les schémas externes doivent être résolus uniquement à partir de sources fiables. |
L'exemple suivant crée un XmlReader qui utilise un XmlSecureResolver avec les informations d'identification 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);
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
Remarque de sécurité