XmlResolver.GetEntity(Uri, String, Type) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
當在衍生類別中覆寫時，會將 URI 映射到包含實際資源的物件。
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 -> objPublic 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 物件。
傳回
如果指定了 stream 以外的類型，則是串流物件 null 。
例外狀況
ofObjectToReturn 不是一種 Stream 類型。
指定的URI並非絕對URI。
absoluteUri 是 null。
會發生執行時錯誤（例如伺服器連線中斷）。
範例
請參考 XmlUrlResolver.GetEntity 使用此方法的範例。
備註
此方法用於呼叫者想要將特定 URI 映射到包含該 URI 所代表實際資源的物件中。 回傳的物件類型是可協商的;然而，實作必須始終支援 System.IO.Stream。
關於此方法的非同步版本，請參見 GetEntityAsync。
Important
您的應用程式可以透過實施一個GetEntity，以限制讀取位元組的數量來減輕對IStream方法的記憶體阻斷服務威脅。 這有助於防範惡意代碼嘗試將無限位元組數據流傳遞至 GetEntity 方法的情況。
