XmlReaderSettings.XmlResolver Eigenschaft

Definition

Legt den XmlResolver fest, der für den Zugriff auf externe Dokumente verwendet wird.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

Eigenschaftswert

Ein XmlResolver, der für den Zugriff auf externe Dokumente verwendet wird.An XmlResolver used to access external documents. Bei Festlegung aufnull wird eine XmlException ausgelöst, wenn der XmlReader auf eine externe Ressource zugreift.If set to null, an XmlException is thrown when the XmlReader tries to access an external resource. Standard ist ein neuer XmlUrlResolver ohne Anmeldeinformationen.The default is a new XmlUrlResolver with no credentials. Ab der .NET Framework-Version 4.5.2 hat diese Einstellung den Standardwert null.Starting with the .NET Framework 4.5.2, this setting has a default value of null.

Beispiele

Im folgenden Beispiel wird eine XmlReader erstellt, die eine XmlSecureResolver mit Standard Anmelde Informationen verwendet.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)

Hinweise

Der XmlResolver wird verwendet, um ein XML-Instanzdokument zu suchen und zu öffnen oder um externe Ressourcen zu suchen und zu öffnen, auf die vom XML-Instanzdokument verwiesen wird.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. Dies kann Entitäten, DTD oder Schemas einschließen.This can include entities, DTD, or schemas. Die XmlResolver.Credentials-Eigenschaft kann verwendet werden, um alle Anmelde Informationen anzugeben, die für die Netzwerk Authentifizierung erforderlich sind.The XmlResolver.Credentials property can be used to specify any credentials required for network authentication.

Wichtig

Da die XmlResolver vertrauliche Informationen, wie z. b. Benutzer Anmelde Informationen, enthalten kann, sollten Sie beim Zwischenspeichern von XmlReaderSettings Objekten oder bei der Übergabe des XmlReaderSettings Objekts von einer Komponente an eine andere Vorsicht walten lassen.Because 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.

Eine XmlSecureResolver kann für den Zugriff auf externe Dokumente verwendet werden.An XmlSecureResolver can be used to access external documents. Die XmlSecureResolver-Klasse trägt zum Schutz einer anderen Implementierung von XmlResolver bei, indem das XmlResolver-Objekt umwickelt und die Ressourcen eingeschränkt werden, auf die der zugrunde liegende XmlResolver Zugriff hat.The 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.

Das ProcessInlineSchema-Validierungsflag und das ProcessSchemaLocation-Validierungsflag eines XmlReaderSettings-Objekts werden nicht standardmäßig festgelegt.The ProcessInlineSchema and ProcessSchemaLocation validation flags of an XmlReaderSettings object are not set by default. Wenn diese Flags festgelegt sind, wird der XmlResolver des XmlReaderSettings-Objekts verwendet, um die im Instanzdokument des XmlReader erkannten Schemaspeicherorte aufzulösen.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. Wenn das XmlResolver Objekt nullist, werden Schema Speicherorte nicht aufgelöst, auch wenn die ProcessInlineSchema-und ProcessSchemaLocation-Validierungsflags festgelegt sind.If the XmlResolver object is null, schema locations are not resolved even if the ProcessInlineSchema and ProcessSchemaLocation validation flags are set.

Durch während der Validierung hinzugefügte Schemas werden neue Typen hinzugefügt, sodass das Validierungsergebnis des überprüften Dokuments möglicherweise geändert wird.Schemas added during validation add new types and can change the validation outcome of the document being validated. Daher sollten externe Schemata nur von vertrauenswürdigen Quellen aufgelöst werden.As a result, external schemas should only be resolved from trusted sources.

Gilt für:

Siehe auch