XmlReaderSettings.XmlResolver Właściwość

Definicja

XmlResolver Ustawia używany do uzyskiwania dostępu do zewnętrznych dokumentów.Sets the XmlResolver used to access external documents.

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 Służy do uzyskiwania dostępu do zewnętrznych dokumentów.An XmlResolver used to access external documents. Jeśli XmlException jest ustawiona nullna, jest generowany, gdy XmlReader próbuje uzyskać dostęp do zasobu zewnętrznego.If set to null, an XmlException is thrown when the XmlReader tries to access an external resource. Wartość domyślna to New XmlUrlResolver bez poświadczeń.The default is a new XmlUrlResolver with no credentials. Począwszy od .NET Framework 4.5.2, to ustawienie ma wartość nulldomyślną.Starting with the .NET Framework 4.5.2, this setting has a default value of null.

Przykłady

Poniższy przykład tworzy XmlReader , który XmlSecureResolver używa z poświadczeniami domyślnymi.The following example creates an XmlReader that uses an XmlSecureResolver with default credentials.

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

XmlResolver Służy do lokalizowania i otwierania dokumentu wystąpienia XML lub do lokalizowania i otwierania wszelkich zasobów zewnętrznych, do których odwołuje się dokument wystąpienia XML.The XmlResolver is used to locate and open an XML instance document, or to locate and open any external resources referenced by the XML instance document. Może to obejmować jednostki, DTD lub schematy.This can include entities, DTD, or schemas. XmlResolver.Credentials Właściwość może służyć do określania poświadczeń wymaganych do uwierzytelniania w sieci.The XmlResolver.Credentials property can be used to specify any credentials required for network authentication.

Ważne

Ponieważ mogą 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 drugiego. XmlResolverBecause the XmlResolver can contain sensitive information such as user credentials, you should be careful when caching XmlReaderSettings objects, or when passing the XmlReaderSettings object from one component to another.

XmlSecureResolver Może służyć do uzyskiwania dostępu do zewnętrznych dokumentów.An XmlSecureResolver can be used to access external documents. Klasa pomaga zabezpieczyć inną XmlResolver implementację przez Zawijanie XmlResolver obiektu i ograniczanie zasobów, do których podstawowy XmlResolver ma dostęp. XmlSecureResolverThe XmlSecureResolver class helps to secure another implementation of XmlResolver by wrapping the XmlResolver object and restricting the resources that the underlying XmlResolver has access to.

Flagi ProcessInlineSchema iProcessSchemaLocation Walidacja obiektuniesąustawianedomyślnie.XmlReaderSettingsThe ProcessInlineSchema and ProcessSchemaLocation validation flags of an XmlReaderSettings object are not set by default. Gdy te flagi są ustawione, XmlResolver XmlReaderSettings obiekt jest używany do rozpoznawania lokalizacji schematu napotkanych w dokumencie wystąpienia w XmlReaderobiekcie.When these flags are set, the XmlResolver of the XmlReaderSettings object is used to resolve schema locations encountered in the instance document in the XmlReader. Jeśli obiekt jest null, lokalizacje schematu ProcessInlineSchema nie są rozpoznawane, nawet jeśli flagi ProcessSchemaLocation i walidacja są ustawione. XmlResolverIf the XmlResolver object is null, schema locations are not resolved even if the ProcessInlineSchema and ProcessSchemaLocation validation flags are set.

Schematy dodane podczas walidacji Dodaj nowe typy i można zmienić wynik walidacji zweryfikowanego dokumentu.Schemas added during validation add new types and can change the validation outcome of the document being validated. W związku z tym schematy zewnętrzne powinny być rozpoznawane tylko z zaufanych źródeł.As a result, external schemas should only be resolved from trusted sources.

Dotyczy

Zobacz też