XmlTextReader.XmlResolver, propriété (System.Xml)

Changer de vue:
ScriptFree
Bibliothèque de classes .NET Framework
XmlTextReader.XmlResolver, propriété

Définit le XmlResolver utilisé pour la résolution des références DTD.

Espace de noms : System.Xml
Assembly : System.Xml (dans system.xml.dll)

Syntaxe

Visual Basic (Déclaration)
Public WriteOnly Property XmlResolver As XmlResolver
Visual Basic (Utilisation)
Dim instance As XmlTextReader
Dim value As XmlResolver

instance.XmlResolver = value
C#
public XmlResolver XmlResolver { set; }
C++
public:
property XmlResolver^ XmlResolver {
	void set (XmlResolver^ value);
}
J#
/** @property */
public void set_XmlResolver (XmlResolver value)

JScript
public function set XmlResolver (value : XmlResolver)

Valeur de la propriété

XmlResolver à utiliser. Si la valeur est référence Null (Nothing en Visual Basic), les ressources externes ne sont pas résolues. Dans la version 1.1 du .NET Framework, l'appelant doit bénéficier d'un niveau de confiance suffisant pour spécifier XmlResolver.
Notes

RemarqueRemarque

Dans la version Microsoft .NET Framework version 2.0, la méthode recommandée consiste à créer des instances XmlReader à l'aide de la méthode System.Xml.XmlReader.Create. Cela vous permet de tirer pleinement parti des nouvelles fonctionnalités incluses dans cette version. Pour plus d'informations, consultez Création de lecteurs XML.

Le lecteur utilise XmlResolver pour résoudre l'emplacement du fichier chargé dans le lecteur ainsi que les références DTD. Par exemple, si votre fichier XML contient la déclaration DOCTYPE, <!DOCTYPE book SYSTEM book.dtd>, le lecteur résout ce fichier externe et vérifie que le DTD est correct. Le lecteur n'utilise pas le DTD pour la validation.

Cette propriété peut être modifiée à tout moment et prend effet lors de l'opération de lecture suivante. Si cette propriété a la valeur référence Null (Nothing en Visual Basic), les références DTD externes rencontrées par le lecteur ne sont pas résolues.

Dans la version 1.1 du .NET Framework, si cette propriété n'est pas définie, le niveau de confiance de l'application détermine le comportement par défaut.

Fully trusted code: Le lecteur utilise un XmlUrlResolver par défaut sans informations d'identification des utilisateurs. Si une authentification est requise pour accéder à une ressource de réseau, utilisez la propriété XmlResolver pour spécifier un XmlResolver avec les informations d'identification nécessaires.

Semi-trusted code: La propriété XmlResolver a la valeur référence Null (Nothing en Visual Basic). Les ressources externes ne sont pas résolues.

Exemple

L'exemple suivant utilise la propriété XmlResolver pour spécifier les informations d'identification nécessaires pour l'accès au fichier sur le réseau.

Visual Basic
Imports System
Imports System.IO
Imports System.Xml
Imports System.Net

public class Sample 

  public shared sub Main() 

    ' Create the reader.
    Dim reader as XmlTextReader = new XmlTextReader("http://myServer/data/books.xml")
   
    ' Supply the credentials necessary to access the Web server.
    Dim resolver as XmlUrlResolver = new XmlUrlResolver()
    resolver.Credentials = CredentialCache.DefaultCredentials
    reader.XmlResolver = resolver

    ' Parse the file.
    while (reader.Read()) 
       ' Do any additional processing here.
    end while           
  
    ' Close the reader.
    reader.Close()     
  
  end sub
end class

C#
using System;
using System.IO;
using System.Xml;
using System.Net;

public class Sample {

  public static void Main() {

    // Create the reader.
    XmlTextReader reader = new XmlTextReader("http://myServer/data/books.xml");
   
    // Supply the credentials necessary to access the Web server.
    XmlUrlResolver resolver = new XmlUrlResolver();
    resolver.Credentials = CredentialCache.DefaultCredentials;
    reader.XmlResolver = resolver;

    // Parse the file.
    while (reader.Read()) {
       // Do any additional processing here.
    }           
  
    // Close the reader.
    reader.Close();     
  
  }
} 

C++
#using <System.dll>
#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
using namespace System::Net;
int main()
{
   
   // Create the reader.
   XmlTextReader^ reader = gcnew XmlTextReader( "http://myServer/data/books.xml" );
   
   // Supply the credentials necessary to access the Web server.
   XmlUrlResolver^ resolver = gcnew XmlUrlResolver;
   resolver->Credentials = CredentialCache::DefaultCredentials;
   reader->XmlResolver = resolver;
   
   // Parse the file.
   while ( reader->Read() )
   {
      
      // Do any additional processing here.
   }

   
   // Close the reader.
   reader->Close();
}


Plates-formes

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.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0
Voir aussi