Teilen über


XmlResolver.GetEntity(Uri, String, Type) Methode

Definition

Weist beim Überschreiben in einer abgeleiteten Klasse einen URI einem Objekt zu, das die eigentliche Ressource enthält.

public:
 abstract System::Object ^ GetEntity(Uri ^ absoluteUri, System::String ^ role, Type ^ ofObjectToReturn);
public abstract object? GetEntity (Uri absoluteUri, string? role, Type? ofObjectToReturn);
public abstract object GetEntity (Uri absoluteUri, string role, Type ofObjectToReturn);
abstract member GetEntity : Uri * string * Type -> obj
Public MustOverride 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

Derzeit nicht verwendet.

ofObjectToReturn
Type

Der Typ des zurückzugebenden Objekts. Die aktuelle Version gibt nur System.IO.Stream-Objekte zurück.

Gibt zurück

Object

Ein stream-Objekt oder null, wenn ein anderer Typ als „stream“ angegeben ist.

Ausnahmen

ofObjectToReturn ist kein Stream-Typ.

Der angegebene URI ist kein absoluter URI.

absoluteUri ist null.

Es ist ein Laufzeitfehler aufgetreten (z. B. eine unterbrochene Serververbindung).

Beispiele

Ein Beispiel mit dieser Methode finden Sie unter XmlUrlResolver.GetEntity Verwendung dieser Methode.

Hinweise

Diese Methode wird verwendet, wenn der Aufrufer einen bestimmten URI in das Objekt zuordnen möchte, das die tatsächliche Ressource enthält, die der URI darstellt. Der zurückgegebene Objekttyp ist verhandelbar; Die Implementierung muss jedoch immer unterstützt System.IO.Streamwerden.

Eine asynchrone Version dieser Methode finden Sie unter GetEntityAsync.

Wichtig

Ihre Anwendung kann Speicherbedrohungen für Dienstbedrohungen GetEntity verringern, indem sie eine IStream Implementierung implementieren, die die Anzahl der Bytes beschränkt, die gelesen werden. Dadurch können Sie vor Situationen schützen, in denen böswilliger Code versucht, einen unendlichen Bytesstrom an die GetEntity Methode zu übergeben.

Gilt für