XmlResolver.GetEntity(Uri, String, Type) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Wanneer deze wordt overschreven in een afgeleide klasse, wijst u een URI toe aan een object dat de werkelijke resource bevat.
public:
abstract System::Object ^ GetEntity(Uri ^ absoluteUri, System::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 ObjectParameters
- absoluteUri
- Uri
De URI geretourneerd van ResolveUri(Uri, String).
- role
- String
Momenteel niet gebruikt.
- ofObjectToReturn
- Type
Het type object dat moet worden geretourneerd. De huidige versie retourneert alleen System.IO.Stream-objecten.
Retouren
Een streamobject of null als een ander type dan stream is opgegeven.
Uitzonderingen
ofObjectToReturn is geen Stream type.
De opgegeven URI is geen absolute URI.
absoluteUri is null.
Er is een runtimefout (bijvoorbeeld een onderbroken serververbinding).
Voorbeelden
Zie XmlUrlResolver.GetEntity voor een voorbeeld met deze methode.
Opmerkingen
Deze methode wordt gebruikt wanneer de aanroeper een bepaalde URI wil toewijzen aan het object met de werkelijke resource die de URI vertegenwoordigt. Het type geretourneerde object is onderhandelbaar; de implementatie moet echter altijd worden ondersteund System.IO.Stream.
Zie voor de asynchrone versie van deze methode GetEntityAsync.
Important
Uw toepassing kan de denial of service-bedreigingen van het geheugen beperken tot de GetEntity methode door een IStream te implementeren die het aantal gelezen bytes beperkt. Dit helpt u te beschermen tegen situaties waarin schadelijke code probeert een oneindige stroom van bytes door te geven aan de GetEntity methode.