XmlPreloadedResolver.GetEntity(Uri, String, Type) Methode

Definition

Namespace:

System.Xml.Resolvers

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Ordnet einem Objekt, das die eigentliche Ressource enthält, einen URI zu.

public:
 override System::Object ^ GetEntity(Uri ^ absoluteUri, System::String ^ role, Type ^ ofObjectToReturn);

public override object? GetEntity (Uri absoluteUri, string? role, Type? ofObjectToReturn);

public override object GetEntity (Uri absoluteUri, string role, Type ofObjectToReturn);

override this.GetEntity : Uri * string * Type -> obj

Public Overrides Function GetEntity (absoluteUri As Uri, role As String, ofObjectToReturn As Type) As Object

Parameter

absoluteUri

Uri

Der von ResolveUri(Uri, String) zurückgegebene URI.

role

String

In der aktuellen Version von .NET Framework für Silverlight wird dieser Parameter beim Auflösen von URIs nicht verwendet. Dieser Parameter wird für die spätere Erweiterbarkeit bereitgestellt. Dieser Parameter kann z. B. xlink:role zugeordnet und als implementierungsspezifisches Argument in anderen Szenarios verwendet werden.

ofObjectToReturn

Type

Der Typ des zurückzugebenden Objekts. Der XmlPreloadedResolver unterstützt Stream-Objekte und TextReader-Objekte für URIs, die als String hinzugefügt wurden. Wenn der angeforderte Typ nicht vom Resolver unterstützt wird, wird eine Ausnahme ausgelöst. Verwenden Sie die SupportsType(Uri, Type)-Methode, um zu ermitteln, ob ein bestimmter Type von diesem Resolver unterstützt wird.

Gibt zurück

Object

Ein Stream oder ein TextReader-Objekt, das der tatsächlichen Quelle entspricht.

Ausnahmen

ArgumentNullException

absoluteUri ist null.

XmlException

In absoluteUri übergebener URI kann nicht aufgelöst werden.

- oder - ofObjectToReturn ist kein unterstützter Typ.

Hinweise

Der XmlPreloadedResolver erste Versuch, die Ressource im Speicher der vorinstallierten Daten nachzuschlagen. Wenn es nicht gefunden werden kann, ruft er die Methode des Fallbacklösers GetEntity auf. Wenn kein Fallbacklöser im XmlPreloadedResolver Konstruktor bereitgestellt wurde, wird eine Ausnahme ausgelöst.