XmlResolver.GetEntity(Uri, String, Type) Metoda

Definicja

Gdy zastąpisz klasę pochodną, mapuje identyfikator URI na obiekt zawierający rzeczywisty zasób.

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

Parametry

absoluteUri
Uri

Identyfikator URI zwrócony z ResolveUri(Uri, String)elementu .

role
String

Obecnie nie jest używany.

ofObjectToReturn
Type

Typ obiektu, który będzie zwracany. Bieżąca wersja zwraca tylko obiekty System.IO.Stream.

Zwraca

Object

Obiekt strumienia lub null jeśli określono typ inny niż strumień.

Wyjątki

ofObjectToReturn nie jest typem Stream .

Określony identyfikator URI nie jest bezwzględnym identyfikatorem URI.

absoluteUri to null.

Wystąpił błąd środowiska uruchomieniowego (na przykład przerwane połączenie z serwerem).

Przykłady

Zobacz XmlUrlResolver.GetEntity przykład użycia tej metody.

Uwagi

Ta metoda jest używana, gdy obiekt wywołujący chce zamapować dany identyfikator URI do obiektu zawierającego rzeczywisty zasób, który reprezentuje identyfikator URI. Zwracany typ obiektu jest możliwy do negocjowania; jednak implementacja musi zawsze obsługiwać .System.IO.Stream

Aby uzyskać asynchroniczną wersję tej metody, zobacz GetEntityAsync.

Ważne

Aplikacja może ograniczyć zagrożenie typu "odmowa usługi" pamięci do GetEntity metody, implementując IStream element, który ogranicza liczbę odczytanych bajtów. Pomaga to chronić przed sytuacjami, w których złośliwy kod próbuje przekazać nieskończony strumień bajtów do GetEntity metody.

Dotyczy