XmlResolver.GetEntity(Uri, String, Type) Metoda

Reference

Definice

Obor názvů:: System.Xml

Sestavení:: System.Xml.ReaderWriter.dll

Sestavení:: System.Xml.dll

Sestavení:: netstandard.dll

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 -> 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.