XmlResolver.GetEntity(Uri, String, Type) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
När den åsidosätts i en härledd klass mappar en URI till ett objekt som innehåller den faktiska resursen.
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 ObjectParametrar
- absoluteUri
- Uri
URI:n som returnerades från ResolveUri(Uri, String).
- role
- String
Används för närvarande inte.
- ofObjectToReturn
- Type
Vilken typ av objekt som ska returneras. Den aktuella versionen returnerar endast System.IO.Stream-objekt.
Returer
Ett strömobjekt eller null om en annan typ än dataström har angetts.
Undantag
ofObjectToReturn är inte en Stream typ.
Den angivna URI:n är inte en absolut URI.
absoluteUri är null.
Det finns ett körningsfel (till exempel en avbruten serveranslutning).
Exempel
Se XmlUrlResolver.GetEntity ett exempel med den här metoden.
Kommentarer
Den här metoden används när anroparen vill mappa en viss URI till objektet som innehåller den faktiska resursen som URI:n representerar. Den typ av objekt som returneras är förhandlingsbar. Implementeringen måste dock alltid stödja System.IO.Stream.
Den asynkrona versionen av den här metoden finns i GetEntityAsync.
Important
Ditt program kan minimera minnesbelastningshot mot GetEntity metoden genom att implementera en IStream som begränsar antalet lästa byte. Detta skyddar mot situationer där skadlig kod försöker skicka en oändlig ström med byte till GetEntity metoden.
