C#中不仅支持Net 平台而且支持COM平台为了支持 COM和NetC# 包含一种称为属性的独特语言特性一个属性实际上就是一个 C# 类它通过修饰源代码来提供元信息属性使 C# 能够支持特定的技术如 COM 和 Net而不会干扰语言规范本身C# 提供将COM接口转换为 C#接口的属性类另一些属性类将 COM类转换为C# 类执行这些转换不需要任何 IDL 或类工厂
现在部署的任何COM 组件都可以在接口转换中使用通常情况下所需的调整是完全自动进行的
特别是可以使用运行时可调用包装 (RCW) 从 NET 框架访问 COM 组件此包装将 COM 组件提供的 COM 接口转换为与 NET 框架兼容的接口对于 OLE 自动化接口RCW 可以从类型库中自动生成对于非 OLE 自动化接口开发人员可以编写自定义 RCW手动将 COM 接口提供的类型映射为与 NET 框架兼容的类型
使用ComImport引用COM组件
COM Interop 提供对现有 COM 组件的访问而不需要修改原始组件使用ComImport引用COM组件常包括下面 几个方面的问题
创建 COM 对象
确定 COM 接口是否由对象实现
调用 COM 接口上的方法
实现可由 COM 客户端调用的对象和接口
创建 COM 类包装
要使 C# 代码引用COM 对象和接口需要在 C# 中包含 COM 接口的定义完成此操作的最简单方法是使用 TlbImpexe（类型库导入程序）它是一个包括在 NET 框架 SDK 中的命令行工具TlbImp 将 COM 类型库转换为 NET 框架元数据从而有效地创建一个可以从任何托管语言调用的托管包装用 TlbImp 创建的 NET 框架元数据可以通过 /R 编译器选项包括在 C# 内部版本中如果使用 Visual Studio 开发环境则只需添加对 COM 类型库的引用将为您自动完成此转换
TlbImp 执行下列转换
COM coclass 转换为具有无参数构造函数的 C# 类
COM 结构转换为具有公共字段的 C# 结构
检查 TlbImp 输出的一种很好的方法是运行 NET 框架 SDK 命令行工具 Ildasmexe（Microsoft 中间语言反汇编程序）来查看转换结果
虽然 TlbImp 是将 COM 定义转换为 C# 的首选方法但也不是任何时候都可以使用它（例如在没有 COM 定义的类型库时或者 TlbImp 无法处理类型库中的定义时就不能使用该方法）在这些情况下另一种方法是使用 C# 属性在 C# 源代码中手动定义 COM 定义创建 C# 源映射后只需编译 C# 源代码就可产生托管包装
执行 COM 映射需要理解的主要属性包括
ComImport它将类标记为在外部实现的 COM 类
Guid它用于为类或接口指定通用唯一标识符 (UUID)
InterfaceType它指定接口是从 IUnknown 还是从 IDispatch 派生
PreserveSig它指定是否应将本机返回值从 HRESULT 转换为 NET 框架异常
声明 COM coclass
COM coclass 在 C# 中表示为类这些类必须具有与其关联的 ComImport 属性下列限制适用于这些类
类不能从任何其他类继承
类不能实现任何接口
类还必须具有为其设置全局唯一标识符 (GUID) 的 Guid 属性
以下示例在 C# 中声明一个 coclass
// 声明一个COM类 FilgraphManager
[ComImport Guid(EEBBFCEFAFBA)]
class FilgraphManager
{ }
C# 编译器将添加一个无参数构造函数可以调用此构造函数来创建 COM coclass 的实例
创建 COM 对象
COM coclass 在 C# 中表示为具有无参数构造函数的类使用 new 运算符创建该类的实例等效于在 C# 中调用 CoCreateInstance使用以上定义的类就可以很容易地实例化此类
class MainClass
{
public static void Main()
{
FilgraphManager filg = new FilgraphManager();
}
}
声明 COM 接口
COM 接口在 C# 中表示为具有 ComImport 和 Guid 属性的接口它不能在其基接口列表中包含任何接口而且必须按照方法在 COM 接口中出现的顺序声明接口成员函数
在 C# 中声明的 COM 接口必须包含其基接口的所有成员的声明IUnknown 和 IDispatch 的成员除外（NET 框架将自动添加这些成员）从 IDispatch 派生的 COM 接口必须用 InterfaceType 属性予以标记
从 C# 代码调用 COM 接口方法时公共语言运行库必须封送与 COM 对象之间传递的参数和返回值对于每个 NET 框架类型均有一个默认类型公共语言运行库将使用此默认类型在 COM 调用间进行封送处理时封送例如C# 字符串值的默认封送处理是封送到本机类型 LPTSTR（指向 TCHAR 字符缓沖区的指针）可以在 COM 接口的 C# 声明中使用 MarshalAs 属性重写默认封送处理
在 COM 中返回成功或失败的常用方法是返回一个 HRESULT并在 MIDL 中有一个标记为retval用于方法的实际返回值的 out 参数在 C#（和 NET 框架）中指示已经发生错误的标准方法是引发异常
默认情况下NET 框架为由其调用的 COM 接口方法在两种异常处理类型之间提供自动映射
返回值更改为标记为 retval 的参数的签名（如果方法没有标记为 retval 的参数则为 void）
标记为 retval 的参数从方法的参数列表中剥离
任何非成功返回值都将导致引发 SystemCOMException 异常
此示例显示用 MIDL 声明的 COM 接口以及用 C# 声明的同一接口（注意这些方法使用 COM 错误处理方法）
下面是接口转换的C#程序
using SystemRuntimeInteropServices;
// 声明一个COM接口 IMediaControl
[Guid(ABADCEBAAFBA)
InterfaceType(ComInterfaceTypeInterfaceIsDual)]
interface IMediaControl // 这里不能列出任何基接口
{
void Run();
void Pause();
void Stop();
void GetState( [In] int msTimeout [Out] out int pfs);
void RenderFile(
[In MarshalAs(UnmanagedTypeBStr)] string strFilename);
void AddSourceFilter(
[In MarshalAs(UnmanagedTypeBStr)] string strFilename
[Out MarshalAs(UnmanagedTypeInterface)] out object ppUnk);
[return : MarshalAs(UnmanagedTypeInterface)]
object FilterCollection();
[return : MarshalAs(UnmanagedTypeInterface)]
object RegFilterCollection();
void StopWhenReady();
}
若要防止 HRESULT 翻译为 COMException请在 C# 声明中将 PreserveSig(true) 属性附加到方法
下面是一个使用C# 映射媒体播放机COM 对象的程序
程序清单 DemonCOMcs
using System;
using SystemRuntimeInteropServices;
namespace QuartzTypeLib
{
//声明一个COM接口 IMediaControl此接口来源于媒体播放机COM类
[Guid(ABADCEBAAFBA)
InterfaceType(ComInterfaceTypeInterfaceIsDual)]
interface IMediaControl
{ //列出接口成员
void Run();
void Pause();
void Stop();
void GetState( [In] int msTimeout [Out] out int pfs);
void RenderFile(
[In MarshalAs(UnmanagedTypeBStr)] string strFilename);
void AddSourceFilter(
[In MarshalAs(UnmanagedTypeBStr)] string strFilename
[Out MarshalAs(UnmanagedTypeInterface)]
out object ppUnk);
[return: MarshalAs(UnmanagedTypeInterface)]
object FilterCollection();
[return: MarshalAs(UnmanagedTypeInterface)]
object RegFilterCollection();
void StopWhenReady();
}
//声明一个COM类:
[ComImport Guid(EEBBFCEFAFBA)]
class FilgraphManager //此类不能再继承其它基类或接口
{
//这里不能有任何代码 系统自动增加一个缺省的构造函数
}
}
class MainClass
{
public static void Main(string[] args)
{
//命令行参数:
if (argsLength != )
{
DisplayUsage();
return;
}
String filename = args[];
if (filenameEquals(/?))
{
DisplayUsage();
return;
}
// 声明FilgraphManager的实类对象
QuartzTypeLibFilgraphManager graphManager =new QuartzTypeLibFilgraphManager();
//声明IMediaControl的实类对象:
QuartzTypeLibIMediaControl mc =(QuartzTypeLibIMediaControl)graphManager;
// 调用COM的方法
mcRenderFile(filename);
//运行文件
mcRun();
//暂借停
ConsoleWriteLine(Press Enter to continue);
ConsoleReadLine();
}
private static void DisplayUsage()
{ // 显示
ConsoleWriteLine(媒体播放机: 播放 AVI 文件);
ConsoleWriteLine(使用方法: VIDEOPLAYEREXE 文件名);
}
}
运行示例
若要显示影片示例 Clockavi请使用以下命令
interop %windir%\clockavi
这将在屏幕上显示影片直到按 ENTER 键停止
在 NET 框架程序中通过DllImport使用 Win API
NET 框架程序可以通过静态 DLL 入口点的方式来访问本机代码库DllImport 属性用于指定包含外部方法的实现的dll 位置
DllImport 属性定义如下
namespace SystemRuntimeInteropServices
{
[AttributeUsage(AttributeTargetsMethod)]
public class DllImportAttribute: SystemAttribute
{
public DllImportAttribute(string dllName) {}
public CallingConvention CallingConvention;
public CharSet CharSet;
public string EntryPoint;
public bool ExactSpelling;
public bool PreserveSig;
public bool SetLastError;
public string Value { get {} }
}
}
说明
DllImport只能放置在方法声明上
DllImport具有单个定位参数指定包含被导入方法的 dll 名称的 dllName 参数
DllImport具有五个命名参数
aCallingConvention 参数指示入口点的调用约定如果未指定 CallingConvention则使用默认值 CallingConventionWinapi
bCharSet 参数指示用在入口点中的字符集如果未指定 CharSet则使用默认值 CharSetAuto
cEntryPoint 参数给出 dll 中入口点的名称如果未指定 EntryPoint则使用方法本身的名称
dExactSpelling 参数指示 EntryPoint 是否必须与指示的入口点的拼写完全匹配如果未指定 ExactSpelling则使用默认值 false
ePreserveSig 参数指示方法的签名应当被保留还是被转换当签名被转换时它被转换为一个具有 HRESULT 返回值和该返回值的一个名为 retval 的附加输出参数的签名如果未指定 PreserveSig则使用默认值 true
fSetLastError 参数指示方法是否保留 Win上一错误如果未指定 SetLastError则使用默认值 false
它是一次性属性类
此外用 DllImport 属性修饰的方法必须具有 extern 修饰符
下面是 C# 调用 Win MessageBox 函数的示例
using System;
using SystemRuntimeInteropServices;
class MainApp
{ //通过DllImport引用userdll类MessageBox来自于userdll类
[DllImport(userdll EntryPoint=MessageBox)]
public static extern int MessageBox(int hWnd String strMessage String strCaption uint uiType);
public static void Main()
{
MessageBox( 您好这是 PInvoke！ NET );
}
}
面向对象的编程语言几乎都用到了抽象类这一概念抽象类为实现抽象事物提供了更大的灵活性C#也不例外 C#通过覆盖虚接口的技术深化了抽象类的应用欲了解这方面的知识请看下一节覆盖虚接口
