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

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kod:

System.Xml.ReaderWriter.dll

Bütünleştirilmiş Kod:

System.Xml.dll

Bütünleştirilmiş Kod:

netstandard.dll

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

XmlException

ofObjectToReturn bir Stream tür değildir.

UriFormatException

Belirtilen URI mutlak bir URI değil.

ArgumentNullException

absoluteUri, null değeridir.

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