XmlResolver.GetEntity(Uri, String, Type) Methode

Referenz

Definition

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.