XmlReaderSettings.XmlResolver Właściwość

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Ustawia element używany do uzyskiwania XmlResolver dostępu do dokumentów zewnętrznych.

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

Wartość właściwości

XmlResolver

Element używany do uzyskiwania XmlResolver dostępu do dokumentów zewnętrznych. Jeśli jest ustawiona wartość null, XmlException element jest zgłaszany podczas XmlReader próby uzyskania dostępu do zasobu zewnętrznego. Wartość domyślna to nowy XmlUrlResolver bez poświadczeń. Począwszy od .NET Framework 4.5.2, to ustawienie ma wartość nulldomyślną .

Przykłady

Poniższy przykład tworzy obiekt XmlReader , który używa elementu XmlSecureResolver z poświadczeniami domyślnymi.

// 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)

Uwagi

Element XmlResolver służy do lokalizowania i otwierania dokumentu wystąpienia XML lub lokalizowania i otwierania wszystkich zasobów zewnętrznych, do których odwołuje się dokument wystąpienia XML. Może to obejmować jednostki, jednostki DTD lub schematy. Właściwość może służyć do określania XmlResolver.Credentials poświadczeń wymaganych do uwierzytelniania sieciowego.

Ważne

XmlResolver Ponieważ element może zawierać poufne informacje, takie jak poświadczenia użytkownika, należy zachować ostrożność podczas buforowania XmlReaderSettings obiektów lub podczas przekazywania XmlReaderSettings obiektu z jednego składnika do innego.

Element może służyć do uzyskiwania XmlSecureResolver dostępu do dokumentów zewnętrznych. Klasa XmlSecureResolver pomaga zabezpieczyć kolejną implementację XmlResolver programu przez opakowywanie XmlResolver obiektu i ograniczanie zasobów, do których podstawowy XmlResolver obiekt ma dostęp.

Flagi ProcessInlineSchema i ProcessSchemaLocation walidacji XmlReaderSettings obiektu nie są ustawiane domyślnie. Gdy te flagi są ustawione, XmlResolver XmlReaderSettings obiekt jest używany do rozpoznawania lokalizacji schematu napotkanych w dokumencie wystąpienia w pliku XmlReader. XmlResolver Jeśli obiekt ma nullwartość , lokalizacje schematu nie są rozpoznawane, nawet jeśli ProcessInlineSchema flagi i ProcessSchemaLocation walidacji są ustawione.

Schematy dodane podczas walidacji dodają nowe typy i mogą zmienić wynik weryfikacji dokumentu, który jest weryfikowany. W związku z tym schematy zewnętrzne powinny być rozpoznawane tylko z zaufanych źródeł.

Zobacz też

• XmlReader
• Create(String)