XmlResolver.GetEntity(Uri, String, Type) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Ha egy származtatott osztály felül van bírálva, az URI-t egy olyan objektumhoz rendeli le, amely a tényleges erőforrást tartalmazza.
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 ObjectParaméterek
- absoluteUri
- Uri
A visszaadott URI a következőből: ResolveUri(Uri, String).
- role
- String
Jelenleg nem használatos.
- ofObjectToReturn
- Type
A visszaadandó objektum típusa. Az aktuális verzió csak System.IO.Stream objektumokat ad vissza.
Válaszok
Streamobjektum, vagy null ha a streamen kívüli típus van megadva.
Kivételek
ofObjectToReturn nem típus Stream .
A megadott URI nem abszolút URI.
absoluteUri az null.
Futásidejű hiba (például megszakadt kiszolgálókapcsolat).
Példák
Tekintse meg XmlUrlResolver.GetEntity ezt a módszert használó példát.
Megjegyzések
Ezt a módszert akkor használja a rendszer, ha a hívó egy adott URI-t az URI által képviselt tényleges erőforrást tartalmazó objektumba szeretne képezni. A visszaadott objektum típusa forgatható; azonban a megvalósításnak mindig támogatnia System.IO.Streamkell.
A metódus aszinkron verziójáról lásd GetEntityAsync: .
Important
Az alkalmazás csökkentheti a GetEntity metódus memóriamegtagadási fenyegetéseit egy IStream olyan implementálással, amely korlátozza az olvasási bájtok számát. Ez segít elhárítani azokat a helyzeteket, amikor a rosszindulatú kód végtelen bájtfolyamot próbál átadni a GetEntity metódusnak.
