XmlResolver.GetEntity(Uri, String, Type) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 -> objPublic MustOverride Function GetEntity (absoluteUri As Uri, role As String, ofObjectToReturn As Type) As ObjectParametry
- absoluteUri
- Uri
Identifikátor URI vrácený z ResolveUri(Uri, String).
- role
- String
V současné době se nepoužívá.
- ofObjectToReturn
- Type
Typ objektu, který se má vrátit. Aktuální verze vrací pouze objekty System.IO.Stream.
Návraty
Objekt datového proudu 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í k serveru).
Příklady
Podívejte se XmlUrlResolver.GetEntity na příklad použití této metody.
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ý identifikátor URI představuje. Typ vráceného objektu je možné vyjednat; implementace však musí vždy podporovat System.IO.Stream.
Asynchronní verzi této metody naleznete v tématu GetEntityAsync.
Important
Aplikace může zmírnit hrozby odepření služby způsobené pamětí pro metodu GetEntity implementováním IStream , která omezuje počet přečtených bajtů. To pomáhá chránit před situacemi, kdy se škodlivý kód pokusí předat do metody nekonečný proud bajtů GetEntity .
