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

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

來源:

XmlSecureResolver.cs

對應 URI 至包含實際資源的物件。 這個方法會呼叫基礎 PermitOnly() 來暫時設定建立在建構函式上的 PermissionSet，然後才呼叫基礎 XmlResolver上的 GetEntity 以開啟資源。

public:
 override System::Object ^ GetEntity(Uri ^ absoluteUri, System::String ^ role, Type ^ ofObjectToReturn);

public override object? GetEntity (Uri absoluteUri, string? role, Type? ofObjectToReturn);

override this.GetEntity : Uri * string * Type -> obj

Public Overrides Function GetEntity (absoluteUri As Uri, role As String, ofObjectToReturn As Type) As Object

參數

absoluteUri

Uri

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

role

String

目前未使用。

ofObjectToReturn

Type

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

傳回

Object

透過呼叫底層 XmlResolver 上的 GetEntity 來傳回的資料流。 若指定了非 Stream 的類型，則方法會傳回 null。

例外狀況

XmlException

ofObjectToReturn 既不是 null 也不是 Stream 型別。

-或-

.NET 7 和更新版本：在所有情況下。

UriFormatException

指定的 URI 並非絕對 URI。

NullReferenceException

absoluteUri 為 null。

Exception

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

備註

重要

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