Sdílet prostřednictvím


XmlResolver.GetEntity(Uri, String, Type) Metoda

Definice

Při přepsání v odvozené třídě mapuje identifikátor URI na objekt, který obsahuje skutečný prostředek.

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

Identifikátor URI vrácený z ResolveUri(Uri, String).

role
String

Aktuálně se nepoužívá.

ofObjectToReturn
Type

Typ objektu, který chcete vrátit. Aktuální verze vrací pouze objekty System.IO.Stream.

Návraty

Object

Objekt streamu nebo null pokud je zadán jiný typ než datový proud.

Výjimky

ofObjectToReturn není Stream typ.

Zadaný identifikátor URI není absolutní identifikátor URI.

absoluteUri je null.

Došlo k chybě za běhu (například přerušené připojení serveru).

Příklady

Příklad XmlUrlResolver.GetEntity použití této metody najdete v tomto příkladu.

Poznámky

Tato metoda se používá, když volající chce mapovat daný identifikátor URI na objekt obsahující skutečný prostředek, který URI představuje. Typ vráceného objektu je možné ověřit; implementace však musí vždy podporovat System.IO.Stream.

Asynchronní verze této metody naleznete v tématu GetEntityAsync.

Důležité

Vaše aplikace může zmírnit hrozby GetEntity pro odepření služby v paměti implementací IStream , která omezuje počet čtení bajtů. To pomáhá chránit před situacemi, kdy se škodlivý kód pokusí předat do metody nekonečný proud bajtů GetEntity .

Platí pro