XmlResolver.GetEntity(Uri, String, Type) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

XmlException

ofObjectToReturn nie jest typem Stream .

UriFormatException

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

ArgumentNullException

absoluteUri to null.

Exception

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

Udostępnij za pośrednictwem