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

当解析 URI 时，.NET Framework for Silverlight 的当前版本不使用此参数。 提供此参数是为了将来扩展使用。 例如，此参数可以映射到 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 未提供回退解析程序，则会引发异常。