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

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

Source:

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

自 ResolveUri(Uri, String) 傳回的 URI。

role

String

目前未使用。

ofObjectToReturn

Type

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

傳回

Object

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

例外狀況

XmlException

ofObjectToReturn 不是 Stream 型別。

UriFormatException

指定的 URI 並非絕對 URI。

ArgumentNullException

absoluteUri 為 null。

Exception

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

範例

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

備註

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

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

重要

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