XmlResolver.GetEntity(Uri, String, Type) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> objPublic MustOverride Function GetEntity (absoluteUri As Uri, role As String, ofObjectToReturn As Type) As ObjectParametri
- 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
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 .