共用方式為


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

定義

在衍生類別中覆寫時,對應 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 -> obj
Public MustOverride Function GetEntity (absoluteUri As Uri, role As String, ofObjectToReturn As Type) As Object

參數

absoluteUri
Uri

ResolveUri(Uri, String) 傳回的 URI。

role
String

目前未使用。

ofObjectToReturn
Type

要傳回的物件類型。 目前的版本只傳回 System.IO.Stream 物件。

傳回

如果指定的類型並非資料流,則為資料流物件或為 null

例外狀況

ofObjectToReturn 不是 Stream 型別。

指定的 URI 並非絕對 URI。

absoluteUrinull

發生執行階段錯誤 (例如中斷的伺服器連線)。

範例

如需使用此方法的範例,請參閱 XmlUrlResolver.GetEntity

備註

當呼叫端想要將指定的 URI 對應至包含 URI 所代表之實際資源的物件時,就會使用這個方法。 傳回的物件類型為一般;不過,實作必須一律支援 System.IO.Stream

如需這個方法的非同步版本,請參閱 GetEntityAsync

重要

您的應用程式可以藉由實作限制讀取位元組數目的 來 IStream 減輕方法的記憶體阻斷服務威脅 GetEntity 。 這有助於防範惡意程式碼嘗試將無限位元組資料流程傳遞至 GetEntity 方法的情況。

適用於