com interop 简述

com interop 简述

在.NET框架下，开发人员可以通过COM interop tools 将COM组件导入导一个应用中去，一旦导入成功，那么我么就可以非常容易地调用COM接口给我们所提供的方法了。

A .NET Framework developer can incorporate COM components into a managed application by using COM interop tools to import the relevant COM types. Once imported, the COM types are ready to use.

一、COM interop 概述:

COM Interop看上去象是介乎于COM和.Net之间的一条纽带，一座桥梁。为了保持向后兼容，COM Interop可以使得.Net程序在不修改原有COM组件的前提下方便的访问COM组件。这一点是非常重要的。事实上，全球的COM组件的代码量估计可能有数十亿行，拥有这些COM组件的公司不可能重写这些组件，所以COM Interop的存在为有此需求的开发者提供了很好的解决方案。

COM和.NET之间存在着非常大的差异，为了使两者可以有机的结合在一起进行协同工作，COM Interop中实际存在着2种桥接方式。一种是RCW，Runtime Callable Wrapper；另一种是CCW，COM Callable Wrapper。RCW是在运行时通过CLR从Interop装配件(Interop Assembly)的元数据中获取相关信息动态的实例化而得到的。使用者将感觉不到自己是在调用COM组件，一切都是这么的自然，和调用一个.Net组件没有任何区别。  

需要注意的是，一个COM组件(指的是一个实例，即一个DLL文件)由且仅由一个RCW负责维护。那么这儿有一个问题了，对于一个COM组件的不同版本，是不是就会有不同的RCW与之相对应呢？答案是肯定的。那有些朋友会说，.Net中的组件不是已经解决了COM中的“DLL HELL”问题了吗？按上面的说法，似乎并没有得到解决嘛？这儿我要说的是，在.Net中导入一个COM组件的不同版本，是会出现此类问题。解决此类问题的方法是使用PIA(Primary Interop Assembly)。

.Net提供三种方法来导入一个COM组件

l         通过Visual Studio .Net提从的“添加引用”功能

l         通过tlbimp.exe实现

l         使用System.Runtime.InteropServices.TypeLibConverter类编程

下面就分别介绍COM的封装、HRESULTs and Exceptions、继承、聚合和包容、如何运用COM interop来生成发出事件和处理事件以及System.Runtime.InteropServices命名空间几个重要的概念

1.        COM的封装(COM Wrappers)

l         在一般的语言(诸如C++)当中在客户端我们一定要控制该COM对象的生命周期

l         客户端的COM对象的方法在C++中的调用通过产生该对象的实例同时获得该对象的接口指针，通过接口指针来访问该对象的方法。在.NET框架下则可以直接通过函数的映射来获得(Clients of .NET objects can obtain a description of an object's functionality using Reflection.)

l         在.NET框架下的运行环境中.NET可以在内存中为.NET重新对象分配内存使用。(NET objects reside in memory managed by the .NET Framework execution environment.)

为了解决上述问题，.NET提供一个COM Wrappers.它可以使得Managed Code 和 Unmanaged Code可以很好结合在一起。COM Wrappers两种桥接方式RCW(runtime callable wrapper)和CCW(COM callable wrapper)其中RCW是将Managed的客户端与Unmanaged的服务器端联接起来的；CCW是将Unmanaged的客户端与 Managed的服务器端联接起来的。

2.        HRESULTs and Exceptions

在COM编程中我们通过HRESULT来判断所做的操作是否成功，在.NET框架下我们通过抛不同的异常(Throw Exceptions)来捕捉错误。

注MSDN给我们列出了HRESULT不同值与.NET的不同异常的对照表。(.NET Framework Developer’s Guide—HRESULTs and Exceptions)

3.        继承、聚合和包容(Inheritance,Aggregation and Containment)

继承：.NET提供一些标准的接口，用户在定义接口时，可以继承这些接口。

聚合：.NET也支持COM提供的聚合的概念即，外对象将内对象的接口暴露在用户面前。

包容：

    通过在外对象的构造函数中创建内对象的实例，这样客户端就可以通过该实例获得接口进行调用接口的各个方法。

4.        如何运用COM interop来生成发出事件和处理事件

在以下内容中，将要描述有关COM对象出接口与事件接收器的连接机制。

关于COM对象的出接口与事件接收器之间的连接机制与在描述COM原理与应用中的机制是一样的，即COM对象声明一个出接口，在事件接收器中表示该接口的实现方法。一旦，COM对象与事件接收器的连接建立好以后，那么客户端就可以随时接收到COM对象服务器端的事件、消息。下面我们从C#的服务器端和事件接收器两个方面来描述这个问题。

Handling Events Raised by a COM Source(描述COM源对象是如何产生一个事件的)

Raising Events Handled by a COM Sink(通过接收器来处理事件)

5.        System.Runtime.InteropServices命名空间

System.Runtime.InteropServices是一个有关访问COM对象以及在.NET框架下的本地API函数。在创建COM接口时经常要运用这个命名空间。

二、C#接口编程

     下面将从接口的定义、接口的访问、接口的实现以及接口的转换编程这些方面来阐述运用C#进行接口编程的方法。

1．接口的定义

接口的声明：

[attributes] [modifiers] interface identifier [:base-list] {interface-body}[;]

l         attributes（可选）：附加的定义性信息。

l         · modifiers（可选）：允许使用的修饰符有new和四个访问修饰符。分别是：new、public、protected、internal、private。在一个接口定义中同一修饰符不允许出现多次，new修饰符只能出现在嵌套接口中，表示覆盖了继承而来的同名成员。The public, protected, internal, and private修饰符定义了对接口的访问权限。

l         指示器和事件。

l         identifier：接口名称。

l         base-list（可选）:包含一个或多个显式基接口的列表，接口间由逗号分隔。

l         interface-body：对接口成员的定义。

l         接口可以是命名空间或类的成员，并且可以包含下列成员的签名：方法、属性、索引器。

l         一个接口可从一个或多个基接口继承。

接口的主体：

               interface-body:  {   interface-member-declarationsopt   }

接口可以包含一个和多个成员，这些成员可以是方法、属性、索引指示器和事件，但不能是常量、域、操作符、构造函数或析构函数，而且不能包含任何静态成员。接口定义创建新的定义空间，并且接口定义直接包含的接口成员定义将新成员引入该定义空间。

   2. 接口的访问

       C#中的CASTS来代替QueryInterface

       (Using Casts Instead of QueryInterface)

在C++中客户端需要通过QueryInterface来获得COM对象的接口指针。在C#编程中却不必这么麻烦。我们可以直接将COM对象对应到相应的COM接口上。如果我们在程序中对应错误，那么在运行时C#会抛出异常。

   3. 接口的实现

              显示地实现接口成员即可以直接利用类来实现接口的成员函数如：

         // Since the .NET Framework interface and coclass have to behave as

         // COM objects, we have to give them guids.

            [Guid("DBE0E8C4-1C61-41f3-B6A4-4E2F353D3D05")]

         public interface IManagedInterface

         {

          int PrintHi(string name);

         }

            [Guid("C6659361-1625-4746-931C-36014B146679")]

         public class InterfaceImplementation : IManagedInterface

         {

         public int PrintHi(string name)

         {

         Console.WriteLine("Hello, {0}!", name);

          return 33;

          }

            }

              通过为Coclass的方法来实现接口如：

[Guid("56A868B1-0AD4-11CE-B03A-0020AF0BA770"),

        InterfaceType(ComInterfaceType.InterfaceIsDual)]

    interface IMediaControl   // Cannot list any base interfaces here

    { // COM methods     }

// Declare FilgraphManager as a COM coclass:

             [ComImport, Guid("E436EBB3-524F-11CE-9F53-0020AF0BA770")]

                  class FilgraphManager   // Cannot have a base class or

                                         // interface list here.

          {

                           // Cannot have any members here

                          // NOTE that the C# compiler will add a default constructor

                          // for you (no parameters).

        }

其中类FilgraphManager实现了ImediaControl的方法其中ComImport--它将类标记为在外部实现的 COM 类。

   4. 接口的转换编程

              运用C#开发COM组件服务器端

l         声明一个COM接口(Declaring a COM Interface):

首先声明一个COM接口我们必须要明确该接口是继承IUnknown or IDispatch或者其他接口。运用C#描述这方面内容必须使用C#提供的属性InterfaceType（InterfaceType – 表明接口是继承于IUnknownor IDispatch）

其次，为了使COM接口中出现成员函数，程序中也要指出ComImport and Guid属性。(Guid—表明接口或者coclass的唯一标示号；ComImport—它将类标记为在外部实现的 COM 类。)

注：coclass是（简称组件对象类――component object class）被包含在DLL或EXE中，并且包含着一个或者多个接口的代码。客户端通过创建该对象的实例来获得COM对象的接口。

例子代码：

[Guid("56A868B1-0AD4-11CE-B03A-0020AF0BA770"),

        InterfaceType(ComInterfaceType.InterfaceIsDual)]

    interface IMediaControl   // Cannot list any base interfaces here

    {

// COM methods

     }

l         声明一个组件对象类(Declaring a COM coclass)

1.        该类不可以继承于其他类。

2.        也不可以实现任何接口。

3.        必须有一个Guid来唯一标示该类

例子代码：

// Declare FilgraphManager as a COM coclass:

             [ComImport, Guid("E436EBB3-524F-11CE-9F53-0020AF0BA770")]

//"E436EBB3-524F-11CE-9F53-0020AF0BA770"标示号在系统注册表中可以找到，说明//此处是调用外部的COM类来实现接口ImediaControl的。

                  class FilgraphManager   // Cannot have a base class or

                                         // interface list here.

          {

                           // Cannot have any members here

                          // NOTE that the C# compiler will add a default constructor

                          // for you (no parameters).

 }

运用C#开发COM组件客户端

l         C#中的CASTS来代替QueryInterface

       (Using Casts Instead of QueryInterface)

在C++中客户端需要通过QueryInterface来获得COM对象的接口指针。在C#编程中却不必这么麻烦。我们可以直接将COM对象对应到相应的COM接口上。如果我们在程序中对应错误，那么在运行时C#会抛出异常。

例子代码：

// Create an instance of a COM coclass:

FilgraphManager graphManager = new FilgraphManager();

// See if it supports the IMediaControl COM interface. 

// Note that this will throw a System.InvalidCastException if 

// the cast fails. This is equivalent to QueryInterface for 

// COM objects:

IMediaControl mc = (IMediaControl) graphManager;

// Now you call a method on a COM interface: 

mc.Run();

l         C#运用抛异常的机制来代替HRESULT

在创建COM对象实例以及获得接口时可能都会出现问题，在C++中我们通过调用HRESULT来判断所做的操作是否成功。但是，在C#编程中我们就不必那么麻烦，C#会抛出诸如System.COMException的异常。

三、关于C#中几个工具的用法

1. Tlbimp.exe的用法：

该工具适合将*.tlb的类库文件可以转换成*.dll的文件，同时该工具还可以将一个dll输出到一个新的dll文件当中去。

例：tlbimp myTest.tlb

    输出 MYTESTLIB.dll的动态联接库文件

   

tlbimp myTest.tlb /out:myTest.dll

    输出生成 myTest.dll的文件

tlbimp c:"winnt"system32"quartz.dll /out:QuartzTypeLib.dll

    将quartz.dll包含到QuartzTypeLib.dll中去。

2. Ildasm工具可以查看*.dll, *.exe, .obj, .lib 文件

例如可以查看.dll的具体情况比如接口、实现类以及成员函数等信息。

    如：可以通过命令Ildasm *.dll来查看具体生成的dll的情况。

3.      Regasm工具用于将dll动态联接库注册到注册表中的操作

如：Regasm QuartzTypeLib.dll

    就将QuartzTypeLib.dll注册到注册表中去。

如果要解除刚才的注册操作可以运用

Regasm /unregister QuartzTypeLib.dll命令即可。

4. CSC工具的使用是编译C#文件*.cs为exe或者dll文件的工具

如：csc File.cs就是将File.cs编译为File.exe文件

    csc /out:my.exe File.cs将File.cs文件编译为my.exe

    csc /target:library File.cs就是将File.cs编译为File.dll文件

5.guidgen工具用于生成Guid号

在C#中使用工具

$"Microsoft Visual Studio .NET 2003"Common7"Tools"$下的工具

guidgen.exe生成一个随机的GUID号。

三、             运用C#开发COM的组件的简单例子

功能概述此例子非常简单就是在服务器端写一个具有现实Hello, **的方法

客户端通过调用服务器端的PrintHi(String name)函数显示出 Hello, **的信息。

服务器端代码：

              //Copyright (C) 2000 Microsoft Corporation. All rights reserved.

// ShiServer.cs

// compile with: /target:library

using System;

using System.Runtime.InteropServices;

namespace ShiServer

{

       // Since the .NET Framework interface and coclass have to behave as

       // COM objects, we have to give them guids.

       [Guid("976F8704-6E29-4b67-AC4F-A5B1226D1F49")]

       public interface IshiInterface

       {

              int PrintHi(string name);

       }

       [Guid("2BDD9B83-E4FC-432a-BBE1-F71C05723AB6")]

       public class IshiImplementation : IshiInterface

       {

              public int PrintHi(string name)

              {

                     Console.WriteLine("Hello, {0}!", name);

                     return 33;

              }

       }

}

         客户端代码：

//Copyright (C) 2000 Microsoft Corporation. All rights reserved.

// shi.cs

// Build with "csc /R:ShiServer.dll shi.cs"

using System;

class MainClass

{

    /************************************************************

  show Hello,sname

    **************************************************************/

    public static void Main(string[] args)

    {

        // input a name

  string sname = args[0];

        // Create instance of ShiServer

        // (Calls CoCreateInstance(D3E09FD9-B987-47f3-89CB-95EFB4D68583,

        // NULL, CLSCTX_ALL, IID_IUnknown, &myHello).

        // Returns null on failure):        

        ShiServer.IshiImplementation myHello=

              new ShiServer.IshiImplementation();

        // QueryInterface for the IshiInterface interface:

        ShiServer.IshiInterface myIhello=

            (ShiServer.IshiInterface)myHello;

              

        // Call some methods on a COM interface

  myIhello.PrintHi(sname);

    }

}

输入： shi stonewall   输出：Hello, stonewall

注：以上资料均来自于

MSDN Library –January 2002

TiTle: C# Programmer’s Reference   COM Interop Tutorials

COM interop 概述http://www.xmlasp.net/n966c13.aspx

What’s new for Interop in .NET Framework v2.0?          http://www.dotnetinterop.com/features/default.aspx?q=Whidbey

C#COM接口编程

http://tech.ccidnet.com/pub/disp/Article?columnID=295&articleID=40725&pageNO=1

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=426988