System.Xml.XmlResolver.GetEntity 方法
方法描述
当在派生类中被重写时，将 URI 映射到包含实际资源的对象。
语法定义(C# System.Xml.XmlResolver.GetEntity 方法 的用法)
public abstract Object GetEntity( Uri absoluteUri, string role, Type ofObjectToReturn )
参数/返回值
| 参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
|---|---|---|
| absoluteUri | System-Uri | 从 ResolveUri 返回的 URI。 |
| role | System-String | 当解析 URI 时，当前版本不使用此参数。提供此参数是为了将来扩展用。例如，它可以映射到 xlink:role 并用作其他方案中的实现特定参数。 |
| ofObjectToReturn | System-Type | 要返回的对象的类型。当前版本只返回 System.IO.Stream 对象。 |
| 返回值 | System.Object | System.IO.Stream 对象；如果指定了流以外的类型，则为 null。 |
提示和注释
当调用方要将给定的 URI 映射到包含该 URI 表示的实际资源的对象时，使用此方法。 所返回对象的类型可以有所变化，但实现必须永远支持 System.IO.Stream。
安全说明
您的应用程序通过实现一个包装的已实现 IStream 来限制字节读取数，可减轻对 GetEntity 方法的内存拒绝服务威胁。 这有助于防止出现恶意代码尝试向 GetEntity 方法传递无限字节流的情况。
System.Xml.XmlResolver.GetEntity 方法例子
有关使用该方法的示例，请参见 XmlUrlResolver.GetEntity。
异常
| 异常 | 异常描述 |
|---|---|
| XmlException | ofObjectToReturn 不是 Stream 类型。 |
| UriFormatException | 指定的 URI 不是一个绝对 URI。 |
| ArgumentNullException | absoluteUri 为 null。 |
| Exception | 存在运行时错误（例如中断的服务器连接）。 |
版本信息
.NET Framework 受以下版本支持：4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持：4、3.5 SP1
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008（不支持服务器核心）, Windows Server 2008 R2（支持 SP1 或更高版本的服务器核心）, Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表，请参见.NET Framework 系统要求。