XmlResolver.GetEntity(Uri, String, Type) Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

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

XmlException

ofObjectToReturn není Stream typ.

UriFormatException

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

ArgumentNullException

absoluteUri je null.

Exception

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 .