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

定义

命名空间:

System.Xml

程序集:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlSecureResolver.cs

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

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

通过调用 GetEntity 基础 XmlResolver调用返回的流。 如果指定了其他 Stream 类型，该方法将 null返回 。

例外

XmlException

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

-或-

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

UriFormatException

指定的 URI 不是绝对 URI。

NullReferenceException

absoluteUri 是 null。

Exception

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

注解

Important

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