XmlResolver.GetEntity(Uri, String, Type) Metodo

Definizione

Quando ne viene eseguito l'override in una classe derivata, esegue il mapping di un URI a un oggetto che contiene la risorsa effettiva.

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

Parametri

absoluteUri
Uri

URI restituito da ResolveUri(Uri, String).

role
String

Attualmente non usato.

ofObjectToReturn
Type

Tipo di oggetto da restituire. Nella versione corrente vengono restituiti solo oggetti System.IO.Stream.

Restituisce

Object

Oggetto flusso o null se viene specificato un tipo diverso dal flusso.

Eccezioni

ofObjectToReturn non è un tipo Stream.

L'URI specificato non è assoluto.

absoluteUri è null.

Errore di runtime, ad esempio un'interruzione della connessione al server.

Esempio

Vedere XmlUrlResolver.GetEntity per un esempio relativo all'uso di questo metodo.

Commenti

Questo metodo viene usato quando il chiamante vuole eseguire il mapping di un determinato URI nell'oggetto contenente la risorsa effettiva rappresentata dall'URI. Il tipo di oggetto restituito è negoziabile; Tuttavia, l'implementazione deve sempre supportare System.IO.Stream.

Per la versione asincrona di questo metodo, vedere GetEntityAsync.

Importante

L'applicazione può attenuare le minacce denial of service di memoria al GetEntity metodo implementando un IStream che limita il numero di byte letti. Ciò consente di proteggersi dalle situazioni in cui il codice dannoso tenta di passare un flusso infinito di byte al GetEntity metodo .

Si applica a