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

定义

命名空间:

System.Xml

程序集:

netstandard.dll, 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。

Important

您的应用程序可以通过实现GetEntity，限制读取的字节数，从而缓解对IStream方法的内存拒绝服务威胁。 这有助于防范恶意代码尝试将无限字节流传递给 GetEntity 方法的情况。