XmlResolver.GetEntity(Uri, String, Type) Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

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

XmlException

ofObjectToReturn non è un tipo Stream.

UriFormatException

L'URI specificato non è assoluto.

ArgumentNullException

absoluteUri è null.

Exception

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 .