XmlResolver.GetEntity(Uri, String, Type) Methode

Definition

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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

XmlException

ofObjectToReturn ist kein Stream-Typ.

UriFormatException

Der angegebene URI ist kein absoluter URI.

ArgumentNullException

absoluteUri ist null.

Exception

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.