XmlSecureResolver.GetEntity(Uri, String, Type) Methode

Definition

Ordnet einem Objekt, das die eigentliche Ressource enthält, einen URI zu. Diese Methode legt temporär das im Konstruktor durch Aufruf von PermissionSet erstellte PermitOnly() fest, bevor GetEntity für den zugrunde liegenden XmlResolver zum Öffnen der Ressource aufgerufen wird.

public:
 override System::Object ^ GetEntity(Uri ^ absoluteUri, System::String ^ role, Type ^ ofObjectToReturn);
public override object? GetEntity (Uri absoluteUri, string? role, Type? ofObjectToReturn);
public override object GetEntity (Uri absoluteUri, string role, Type ofObjectToReturn);
override this.GetEntity : Uri * string * Type -> obj
Public Overrides 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 Stream-Objekte zurück.

Gibt zurück

Der durch Aufruf von GetEntity für die zugrunde liegende XmlResolver-Klasse zurückgegebene Datenstrom. Wenn ein anderer Typ als Stream angegeben ist, gibt die Methode null zurück.

Ausnahmen

ofObjectToReturn ist weder null noch vom Typ Stream.

Oder

.NET 7 und höhere Versionen: In allen Fällen.

Der angegebene URI ist kein absoluter URI.

absoluteUri ist null.

Es gibt einen Laufzeitfehler (z. B. eine unterbrochene Serververbindung).

Hinweise

Wichtig

Ihre Anwendung kann Speicher-Denial-of-Service-Bedrohungen für die GetEntity -Methode verringern, indem sie ein implementiert, IStream das die Anzahl der gelesenen Bytes begrenzt. Dies hilft beim Schutz vor Situationen, in denen bösartiger Code versucht, einen unendlichen Datenstrom von Bytes an die GetEntity -Methode zu übergeben.

Gilt für: