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.
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird ein URI einem Objekt zugeordnet, das die tatsächliche 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).
- 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 Streamobjekt oder null ein anderer Typ als "Stream" angegeben ist.
Ausnahmen
ofObjectToReturn ist kein Stream Typ.
Der angegebene URI ist kein absoluter URI.
absoluteUri ist null.
Es gibt einen Laufzeitfehler (z. B. eine unterbrochene Serververbindung).
Beispiele
Ein Beispiel für diese Methode finden Sie XmlUrlResolver.GetEntity unter Verwendung dieser Methode.
Hinweise
Diese Methode wird verwendet, wenn der Aufrufer einen bestimmten URI dem Objekt zuordnen möchte, das die tatsächliche Ressource enthält, die der URI darstellt. Der typ des zurückgegebenen Objekts ist verhandelbar; Die Implementierung muss jedoch immer unterstützt werden System.IO.Stream.
Die asynchrone Version dieser Methode finden Sie unter GetEntityAsync.
Important
Ihre Anwendung kann Speicherverweigerungsbedrohungen für die GetEntity-Methode abschwächen, indem sie eine IStream-Implementierung verwendet, die die Anzahl der gelesenen Bytes begrenzt. Dadurch können Sie vor Situationen schützen, in denen bösartiger Code versucht, einen unendlichen Bytestrom an die GetEntity Methode zu übergeben.
