XmlSecureResolver.GetEntity(Uri, String, Type) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlSecureResolver.cs

Memetakan URI ke objek yang berisi sumber daya aktual. Metode ini untuk sementara mengatur yang dibuat di konstruktor dengan memanggil PermissionSet sebelum memanggil PermitOnly() pada yang mendasar GetEntityXmlResolver untuk membuka sumber daya.

public:
 override System::Object ^ GetEntity(Uri ^ absoluteUri, System::String ^ role, Type ^ ofObjectToReturn);

public override object? GetEntity(Uri absoluteUri, string? role, Type? ofObjectToReturn);

override this.GetEntity : Uri * string * Type -> obj

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

Parameter

absoluteUri

Uri

URI yang dikembalikan dari ResolveUri(Uri, String).

role

String

Saat ini tidak digunakan.

ofObjectToReturn

Type

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

Mengembalikan

Object

Aliran dikembalikan dengan memanggil GetEntity pada yang mendasar XmlResolver. Jika jenis selain Stream ditentukan, metode mengembalikan null.

Pengecualian

XmlException

ofObjectToReturnbukan null tipe.Stream

-atau-

.NET 7 dan versi yang lebih baru: Dalam semua kasus.

UriFormatException

URI yang ditentukan bukan URI absolut.

NullReferenceException

absoluteUri adalah null.

Exception

Ada kesalahan run-time (misalnya, koneksi server yang terganggu).

Keterangan

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 .