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 流传递给 方法的情况。