XmlResolver.GetEntity(Uri, String, Type) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlResolver.cs

Saat ditimpa di kelas turunan, memetakan URI ke objek yang berisi sumber daya aktual.

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 -> obj

Public MustOverride Function GetEntity (absoluteUri As Uri, role As String, ofObjectToReturn As Type) As Object

Parameter

absoluteUri

Uri

URI dikembalikan dari ResolveUri(Uri, String).

role

String

Saat ini tidak digunakan.

ofObjectToReturn

Type

Jenis objek yang akan dikembalikan. Versi saat ini hanya mengembalikan objek System.IO.Stream.

Mengembalikan

Object

Objek streaming atau null jika jenis selain aliran ditentukan.

Pengecualian

XmlException

ofObjectToReturn bukan tipe Stream .

UriFormatException

URI yang ditentukan bukan URI absolut.

ArgumentNullException

absoluteUri adalah null.

Exception

Ada kesalahan runtime (misalnya, koneksi server yang terganggu).

Contoh

Lihat XmlUrlResolver.GetEntity contoh menggunakan metode ini.

Keterangan

Metode ini digunakan ketika penelepon ingin memetakan URI tertentu ke dalam objek yang berisi sumber daya aktual yang diwakili URI. Jenis objek yang dikembalikan dapat dinegosiasikan; namun, implementasi harus selalu mendukung System.IO.Stream.

Untuk versi asinkron dari metode ini, lihat GetEntityAsync.

Important

Aplikasi Anda dapat mengurangi ancaman penolakan layanan memori terhadap metode GetEntity dengan menerapkan IStream yang membatasi jumlah byte yang dibaca. Ini membantu melindungi dari situasi di mana kode berbahaya mencoba meneruskan aliran byte tak terbatas ke GetEntity metode .