XmlTextReader.XmlResolver Eigenschaft

Definition

Legt den XmlResolver fest, der zur Auflösung von DTD-Verweisen verwendet wird.

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

Eigenschaftswert

Der zu verwendende XmlResolver. Wenn er auf null festgelegt ist, werden externe Ressourcen nicht aufgelöst.

In Version 1.1 der .NET Framework muss der Aufrufer vollständig vertrauenswürdig sein, um einen XmlResolveranzugeben.

Beispiele

Im folgenden Beispiel wird die XmlResolver -Eigenschaft verwendet, um die Anmeldeinformationen anzugeben, die für den Zugriff auf die Netzwerkdatei erforderlich sind.

#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();
}
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();
  }
}
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

Hinweise

Hinweis

Ab dem .NET Framework 2.0 wird empfohlen, Instanzen mithilfe der XmlReader.Create -Methode zu erstellenXmlReader, um die neuen Funktionen zu nutzen.

Der Reader verwendet XmlResolver , um den Speicherort der datei aufzulösen, die in den Reader geladen wurde, und auch, um DTD-Verweise aufzulösen. Wenn Ihr XML beispielsweise die DOCTYPE-Deklaration enthält, <!DOCTYPE book SYSTEM book.dtd> löst der Reader diese externe Datei auf und stellt sicher, dass die DTD wohlgeformt ist. Der Reader verwendet die DTD nicht für die Validierung.

Diese Eigenschaft kann jederzeit geändert werden und wird beim nächsten Lesevorgang wirksam. Wenn diese Eigenschaft auf nullfestgelegt ist, werden alle externen DTD-Verweise, die vom Reader gefunden werden, nicht aufgelöst.

Wenn diese Eigenschaft in Version 1.1 der .NET Framework nicht festgelegt ist, bestimmt die Vertrauensstellungsebene der Anwendung das Standardverhalten.

Fully trusted code: Der Reader verwendet eine Standardeinstellung XmlUrlResolver ohne Benutzeranmeldeinformationen. Wenn die Authentifizierung für den Zugriff auf eine Netzwerkressource erforderlich ist, verwenden Sie die XmlResolver -Eigenschaft, um einen XmlResolver mit den erforderlichen Anmeldeinformationen anzugeben.

Semi-trusted code: Die XmlResolver -Eigenschaft ist auf nullfestgelegt. Externe Ressourcen werden nicht aufgelöst.

Gilt für:

Weitere Informationen