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

Tanım

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);
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

ofObjectToReturn bir Stream tür değildir.

Belirtilen URI mutlak bir URI değil.

absoluteUri, null değeridir.

Ç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 nesnenin 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. .

Önemli

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

Şunlara uygulanır