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

定義

命名空間:

System.Xml.Resolvers

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.dll

組件:

netstandard.dll

對應 URI 至包含實際資源的物件。

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

public override object? GetEntity (Uri absoluteUri, 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

目前的 .NET Framework for Silverlight 版本在解析 URI 時不使用這個參數。 提供這個參數的目的是要供未來擴充使用。 例如，這個參數可對應至 xlink:role 並在其他情節中當做實作專屬的引數使用。

ofObjectToReturn

Type

要傳回的物件類型。 針對以 String 形式加入的 URI，XmlPreloadedResolver 支援 Stream 物件和 TextReader 物件。 如果解析程式不支援要求的型別，則會擲回例外狀況。 請使用 SupportsType(Uri, Type) 方法，判斷此解析程式是否支援特定 Type。

傳回

Object

對應於實際來源的 Stream 或 TextReader 物件。

例外狀況

ArgumentNullException

absoluteUri 為 null。

XmlException

無法解析 absoluteUri 中傳遞的 URI。

-或- ofObjectToReturn 不是支援的型別。

備註

XmlPreloadedResolver會先嘗試在預先載入的資料存放區中查閱資源。 如果找不到它，它會呼叫後援解析程式 GetEntity 的方法。 如果建構函式中 XmlPreloadedResolver 未提供後援解析程式，則會擲回例外狀況。