XmlResolver.GetEntity(Uri, String, Type) 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlResolver.cs

當在衍生類別中覆寫時，會將 URI 映射到包含實際資源的物件。

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

參數

absoluteUri

Uri

URI 從 ResolveUri(Uri, String)返回。

role

String

目前未使用。

ofObjectToReturn

Type

要歸還的物品類型。 目前版本僅回傳 System.IO.Stream 物件。

傳回

Object

如果指定了 stream 以外的類型，則是串流物件 null 。

例外狀況

XmlException

ofObjectToReturn 不是一種 Stream 類型。

UriFormatException

指定的URI並非絕對URI。

ArgumentNullException

absoluteUri 是 null。

Exception

會發生執行時錯誤（例如伺服器連線中斷）。

範例

請參考 XmlUrlResolver.GetEntity 使用此方法的範例。

備註

此方法用於呼叫者想要將特定 URI 映射到包含該 URI 所代表實際資源的物件中。 回傳的物件類型是可協商的;然而，實作必須始終支援 System.IO.Stream。

關於此方法的非同步版本，請參見 GetEntityAsync。

Important

您的應用程式可以透過實施一個GetEntity，以限制讀取位元組的數量來減輕對IStream方法的記憶體阻斷服務威脅。 這有助於防範惡意代碼嘗試將無限位元組數據流傳遞至 GetEntity 方法的情況。