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

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将 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);

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

当前未使用。

要返回的对象的类型。当前版本只返回 Stream 对象。

Object

通过对基础 XmlResolver 调用 GetEntity 而返回的流。如果指定除 Stream 以外的类型，方法将返回 null。

XmlException

ofObjectToReturn 既不是 null 也不是 Stream 类型。

-或-

.NET 7 及更高版本：在所有情况下。

指定的 URI 不是一个绝对 URI。

absoluteUri 为 null。

Exception

(出现运行时错误，例如服务器连接中断) 。

重要

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