XmlReaderSettings.XmlResolver XmlReaderSettings.XmlResolver XmlReaderSettings.XmlResolver XmlReaderSettings.XmlResolver Property

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

Das folgende Beispiel erstellt eine XmlReader , verwendet eine XmlSecureResolver mit Standardanmeldeinformationen.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

Die XmlResolver dient zum Suchen und öffnen Sie eine XML-Instanzendokument oder zum Suchen und öffnen Sie keine externen Ressourcen, die von dem 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 die Entitäten, DTD oder Schemas einschließen.This can include entities, DTD, or schemas. Die XmlResolver.Credentials Eigenschaft kann verwendet werden, um Anmeldeinformationen für die Netzwerkauthentifizierung erforderlich angegeben.The XmlResolver.Credentials property can be used to specify any credentials required for network authentication.

Wichtig

Da die XmlResolver können vertrauliche Informationen enthalten wie die Anmeldeinformationen, sollten Sie vorsichtig beim Zwischenspeichern von XmlReaderSettings Objekte oder bei der Übergabe der XmlReaderSettings Objekt von einer Komponente zu einem anderen.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.

Ein XmlSecureResolver Zugriff auf externe Dokumente verwendet werden können.An XmlSecureResolver can be used to access external documents. Die XmlSecureResolver Klasse hilft, eine andere Implementierung der XmlResolver durch Umschließen der XmlResolver -Objekt und die Ressourcen beschränkt, die die zugrunde liegende XmlResolver hat Zugriff auf.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 die XmlResolver Objekt null, Schemaspeicherorte nicht aufgelöst, wenn die ProcessInlineSchema und ProcessSchemaLocation Validierungsflag 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