XmlResolver.GetEntity(Uri, String, Type) Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlResolver.cs

Türetilmiş bir sınıfta geçersiz kılındığında, bir URI'yi gerçek kaynağı içeren bir nesneyle eşler.

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

Parametreler

absoluteUri

Uri

'den ResolveUri(Uri, String)döndürülen URI.

role

String

Şu anda kullanılmıyor.

ofObjectToReturn

Type

Döndürülecek nesnenin türü. Geçerli sürüm yalnızca System.IO.Stream nesnelerini döndürür.

Döndürülenler

Object

Akış nesnesi veya null akış dışında bir tür belirtilmişse.

Özel durumlar

XmlException

ofObjectToReturn bir Stream tür değildir.

UriFormatException

Belirtilen URI mutlak bir URI değil.

ArgumentNullException

absoluteUri, null'e eşittir.

Exception

Çalışma zamanı hatası (örneğin, kesintiye uğramış bir sunucu bağlantısı) vardır.

Örnekler

Bu yöntemi kullanan bir örnek için bkz XmlUrlResolver.GetEntity .

Açıklamalar

Çağıran belirli bir URI'yi URI'nin temsil ettiği gerçek kaynağı içeren nesneye eşlemek istediğinde bu yöntem kullanılır. Döndürülen nesne türü tartışılabilir; ancak, uygulamanın her zaman desteklemesi System.IO.Streamgerekir.

Bu yöntemin zaman uyumsuz sürümü için bkz GetEntityAsync. .

Important

Uygulamanız, okunan bayt sayısını sınırlayan bir GetEntity uygulayarak yönteme IStream yönelik hizmet tehditlerinin bellek reddini azaltabilir. Bu, kötü niyetli kodun GetEntity yöntemine sonsuz sayıda bayt akışı göndermeye çalıştığı durumlara karşı korunmaya yardımcı olur.