基于c#的接口基础教程之六_c#教程

　　第六节、接口转换

　　C#中不但支持.Net 平台，而且支持COM平台。为了支持 COM和.Net，C# 包含一种称为属性的独特语言特性。一个属性实际上就是个 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组件常包括下面 几个方面的问题：

　　1、创建 COM 对象。

　　2、确定 COM 接口是否由对象实现。

　　3、调用 COM 接口上的方法。

　　4、实现可由 COM 客户端调用的对象和接口。

　　创建 COM 类包装

　　要使 C# 代码引用COM 对象和接口，需要在 C# 中包含 COM 接口的定义。完成此操作的最简单方法是使用 TlbImp.exe（类型库导入程式），他是个包括在 .NET 框架 SDK 中的命令行工具。TlbImp 将 COM 类型库转换为 .NET 框架元数据，从而有效地创建一个能够从任何托管语言调用的托管包装。用 TlbImp 创建的 .NET 框架元数据能够通过 /R 编译器选项包括在 C# 内部版本中。假如使用 Visual Studio 研发环境，则只需添加对 COM 类型库的引用，将为您自动完成此转换。

　　TlbImp 执行下列转换：

　　1、COM coclass 转换为具备无参数构造函数的 C# 类。

　　2、COM 结构转换为具备公共字段的 C# 结构。

　　检查 TlbImp 输出的一种很好的方法是运行 .NET 框架 SDK 命令行工具 Ildasm.exe（Microsoft 中间语言反汇编程式）来查看转换结果。

　　虽然 TlbImp 是将 COM 定义转换为 C# 的最好选择方法，但也不是任何时候都能够使用他（例如，在没有 COM 定义的类型库时或 TlbImp 无法处理类型库中的定义时，就不能使用该方法）。在这些情况下，另一种方法是使用 C# 属性在 C# 源代码中手动定义 COM 定义。创建 C# 源映射后，只需编译 C# 源代码就可产生托管包装。

　　执行 COM 映射需要理解的主要属性包括：

　　1、ComImport：他将类标记为在外部实现的 COM 类。

　　2、Guid：他用于为类或接口指定通用唯一标识符 (UUID)。

　　3、InterfaceType，他指定接口是从 IUnknown 还是从 IDispatch 派生。

　　4、PreserveSig，他指定是否应将本机返回值从 HRESULT 转换为 .NET 框架异常。
　　声明 COM coclass

　　COM coclass 在 C# 中表示为类。这些类必须具备和其关联的 ComImport 属性。下列限制适用于这些类：

　　1、类不能从任何其他类继承。

　　2、类不能实现任何接口。

　　4、类还必须具备为其配置全局唯一标识符 (GUID) 的 Guid 属性。

　　以下示例在 C# 中声明一个 coclass：

// 声明一个COM类 FilgraphManager
[ComImport, Guid("E436EBB3-524F-11CE-9F53-0020AF0BA770")]
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 的参数从方法的参数列表中剥离。

　　任何非成功返回值都将导致引发 System.COMException 异常。

　　此示例显示用 MIDL 声明的 COM 接口连同用 C# 声明的同一接口（注意这些方法使用 COM 错误处理方法）。

　　下面是接口转换的C#程式：

using System.Runtime.InteropServices;
// 声明一个COM接口 IMediaControl
[Guid("56A868B1-0AD4-11CE-B03A-0020AF0BA770"),
InterfaceType(ComInterfaceType.InterfaceIsDual)]
interface IMediaControl // 这里不能列出任何基接口
{
void Run();
void Pause();
void Stop();
void GetState( [In] int msTimeout, [Out] out int pfs);

标签：

版权申明：本站文章部分自网络，如有侵权，请联系：west999com@outlook.com
特别注意：本站所有转载文章言论不代表本站观点，本站所提供的摄影照片，插画，设计作品，如需使用，请与原作者联系，版权归原作者所有