XmlUrlResolver.GetEntity(Uri, String, Type) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Memetakan URI ke objek yang berisi sumber daya aktual.
public:
override System::Object ^ GetEntity(Uri ^ absoluteUri, System::String ^ role, Type ^ ofObjectToReturn);
public override object? GetEntity(Uri absoluteUri, 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 dikembalikan dari ResolveUri(Uri, String).
- role
- String
Saat ini tidak digunakan.
- ofObjectToReturn
- Type
Jenis objek yang akan dikembalikan. Implementasi saat ini hanya mengembalikan Stream objek.
Mengembalikan
Objek streaming atau null jika jenis selain aliran ditentukan.
Pengecualian
ofObjectToReturnbukan null tipe.Stream
URI yang ditentukan bukan URI absolut.
absoluteUri adalah null.
Ada kesalahan runtime (misalnya, koneksi server yang terganggu).
Contoh
Contoh berikut menunjukkan GetEntity metode dan ResolveUri .
using System;
using System.IO;
using System.Xml;
public class Sample
{
public static void Main()
{
XmlUrlResolver resolver = new XmlUrlResolver();
Uri baseUri = new Uri ("http://servername/tmp/test.xsl");
Uri fulluri=resolver.ResolveUri(baseUri, "includefile.xsl");
// Get a stream object containing the XSL file
Stream s=(Stream)resolver.GetEntity(fulluri, null, typeof(Stream));
// Read the stream object displaying the contents of the XSL file
XmlTextReader reader = new XmlTextReader(s);
while (reader.Read())
{
Console.WriteLine(reader.ReadOuterXml());
}
}
}
Imports System.IO
Imports System.Xml
Public Class Sample
Public Shared Sub Main()
Dim resolver As New XmlUrlResolver()
Dim baseUri As New Uri("http://servername/tmp/test.xsl")
Dim fulluri As Uri = resolver.ResolveUri(baseUri, "includefile.xsl")
' Get a stream object containing the XSL file
Dim s As Stream = CType(resolver.GetEntity(fulluri, Nothing, GetType(Stream)), Stream)
' Read the stream object displaying the contents of the XSL file
Dim reader As New XmlTextReader(s)
While reader.Read()
Console.WriteLine(reader.ReadOuterXml())
End While
End Sub
End Class
Keterangan
Metode ini digunakan ketika penelepon ingin memetakan URI tertentu ke objek yang berisi sumber daya yang diwakili URI.
Untuk versi asinkron dari metode ini, lihat GetEntityAsync.
Important
Aplikasi Anda dapat mengurangi penolakan memori ancaman layanan ke GetEntity metode dengan menerapkan IStream IStream untuk membatasi jumlah byte yang dibaca. Ini membantu melindungi dari situasi di mana kode berbahaya mencoba meneruskan aliran byte tak terbatas ke GetEntity metode .