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

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

Source:

XmlSecureResolver.cs

将 URI 映射到包含实际资源的对象。 此方法在对基础 XmlResolver 调用GetEntity 之前，先调用 PermitOnly()，以临时设置构造函数中创建的 PermissionSet，从而打开该资源。

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 方法的情况。