XmlResolver.GetEntity(Uri, String, Type) Methode
Definition
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 -> objPublic MustOverride Function GetEntity (absoluteUri As Uri, role As String, ofObjectToReturn As Type) As ObjectParameter
- 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
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.