XmlTextReader.XmlResolver Właściwość

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Źródło:

XmlTextReader.cs

XmlResolver Ustawia używane do rozpoznawania odwołań DTD.

public:
 property System::Xml::XmlResolver ^ XmlResolver {  void set(System::Xml::XmlResolver ^ value); };

public System.Xml.XmlResolver? XmlResolver { set; }

member this.XmlResolver : System.Xml.XmlResolver

Public Property XmlResolver As XmlResolver

Wartość właściwości

XmlResolver

Element XmlResolver do użycia. Jeśli ustawiono wartość null, zasoby zewnętrzne nie zostaną rozwiązane.

W wersji 1.1 .NET Framework obiekt wywołujący musi być w pełni zaufany, aby określić element XmlResolver.

Przykłady

W poniższym przykładzie użyto XmlResolver właściwości , aby określić poświadczenia niezbędne do uzyskania dostępu do pliku sieciowego.

#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

Uwagi

Uwaga

Począwszy od .NET Framework 2.0, zalecamy utworzenie XmlReader wystąpień przy użyciu XmlReader.Create metody , aby korzystać z nowych funkcji.

Czytnik używa XmlResolver metody do rozpoznawania lokalizacji pliku załadowanego do czytnika, a także do rozpoznawania odwołań DTD. Jeśli na przykład plik XML zawiera deklarację DOCTYPE, <!DOCTYPE book SYSTEM book.dtd> czytnik rozpozna ten plik zewnętrzny i gwarantuje, że kod DTD jest poprawnie sformułowany. Czytnik nie używa identyfikatora DTD do weryfikacji.

Tę właściwość można zmienić w dowolnym momencie i będzie obowiązywać przy następnej operacji odczytu. Jeśli ta właściwość jest ustawiona na nullwartość , żadne zewnętrzne odwołania DTD napotkane przez czytelnika nie zostaną rozwiązane.

W wersji 1.1 .NET Framework, jeśli ta właściwość nie jest ustawiona, poziom zaufania aplikacji określa zachowanie domyślne.

Fully trusted code: Czytelnik używa wartości domyślnej XmlUrlResolver bez poświadczeń użytkownika. Jeśli wymagane jest uwierzytelnienie w celu uzyskania dostępu do zasobu sieciowego, użyj XmlResolver właściwości , aby określić element XmlResolver z wymaganymi poświadczeniami.

Semi-trusted code: Właściwość jest ustawiona XmlResolver na nullwartość . Zasoby zewnętrzne nie są rozwiązywane.

Zobacz też

• Credentials
• CredentialCache
• NetworkCredential
• XmlSecureResolver
• XmlReader