System.Activator.CreateComInstanceFrom 方法 (String, String, Byte[], AssemblyHashAlgorithm)
方法描述
使用命名的程序集文件和默认构造函数,创建指定名称的 COM 对象的实例。
语法定义(C# System.Activator.CreateComInstanceFrom 方法 (String, String, Byte[], AssemblyHashAlgorithm) 的用法)
public static ObjectHandle CreateComInstanceFrom( string assemblyName, string typeName, byte[] hashValue, AssemblyHashAlgorithm hashAlgorithm )
参数/返回值
参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
---|---|---|
assemblyName | System-String | 包含某程序集的文件的名称,将在该程序集内查找名为 typeName 的类型。 |
typeName | System-String | 首选类型的名称。 |
hashValue | System-Byte[] | 计算所得的哈希代码的值。 |
hashAlgorithm | System-Configuration-Assemblies-AssemblyHashAlgorithm | 用于哈希文件和生成强名称的哈希算法。 |
返回值 | System.Runtime.Remoting.ObjectHandle | 要访问新创建的实例则必须解包的句柄。 |
提示和注释
使用 ObjectHandle.Unwrap 方法解包返回值。
必须以显式方式或默认方式对 COM 类型应用值为 true 的 System.Runtime.InteropServices.ComVisibleAttribute 特性,这样,CreateComInstanceFrom 方法才能创建该类型的实例;否则,会引发 TypeLoadException。
有关所调用方法可以引发的其他异常的信息,请参见 Assembly.LoadFrom 和 CreateInstance 方法的“异常”节。
注意
从 .NET Framework 2.0 版 Service Pack 1 开始,如果已使用 ReflectionPermissionFlag.RestrictedMemberAccess 标志授予调用方 ReflectionPermission,并且包含非公共类型的程序集的授予集限制为调用方的授予集或其子集,则此方法可用于创建非公共类型。 (请参见 反射的安全注意事项。)
若要使用此功能,您的应用程序应面向 .NET Framework 3.5 版 或更高版本。
System.Activator.CreateComInstanceFrom 方法 (String, String, Byte[], AssemblyHashAlgorithm)例子
异常
异常 | 异常描述 |
---|---|
ArgumentNullException | typeName 或 assemblyName 为 null。 |
ArgumentException | assemblyName 是空字符串 ("")。 |
PathTooLongException | 用两个不同的证据将一个程序集或模块加载了两次,或者程序集的名称比 MAX_PATH 字符长。 |
FileNotFoundException | 未找到 assemblyName,或者尝试加载的模块没有指定文件扩展名。 |
FileLoadException | assemblyName 已找到,但是不能加载。 |
BadImageFormatException | assemblyName 不是有效程序集。 |
SecurityException | 在没有必需的 WebPermission 的情况下,指定了不以“file://”开始的基本代码。 |
TypeLoadException |
|
MissingMethodException | 未找到匹配的构造函数。 |
MemberAccessException |
|
NotSupportedException | 调用方无法为不是从 MarshalByRefObject 继承的对象提供激活特性。 |
版本信息
.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1 .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 系统要求。