C# 互操作性入门系列(四):在C# 中调用COM组件

摘要:
然而如果.NET平台下的程序想访问COM组件的方式来实现某个功能怎么办呢?正是由于开发人员有这个需求,所以微软在.NETFrameWork中为COM和托管代码之间进行互操作提供了支持,这种互操作性的技术就是COMInterop。下面就从一个具体的实例来看看在.NET中是如何调用COM组件的。

本文转载自:https://www.cnblogs.com/zhili/archive/2013/01/27/COMInterop.html

本专题概要:

  • 引言
  • 如何在C#中调用COM组件——访问Office 互操作对象
  • 在C# 中调用COM组件的实现原理剖析
  • 错误处理
  • 小结

一、引言

COM(Component Object Modele,组件对象模型)是微软以前推崇的一个开发技术,所以现在微软的很多产品都用到了COM组件,如Office,IE等。然而如果.NET 平台下的程序想访问COM组件的方式来实现某个功能怎么办呢? 正是由于开发人员有这个需求,所以微软在.NET FrameWork中为COM和托管代码之间进行互操作提供了支持,这种互操作性的技术就是COM Interop。但是COM Interop(COm互操作)这项技术,不仅支持在托管代码中使用COM对象,并且也支持在COM中使用托管对象,本专题只针对在.NET中调用COM对象来介绍,由于COM技术现在用的不多,所以如何在COM中使用托管对象将不会在本系列中做出介绍,如果有需要的朋友可以参看MSDN的相关链接:http://msdn.microsoft.com/zh-cn/library/3y76b69k(v=vs.100).aspx

下面就从一个具体的实例来看看在.NET 中是如何调用COM组件的。

二、如何在C#中调用COM组件——访问Office 互操作对象

因为Office产品中使用了很多COM组件,下面就演示通过调用Office中的COM对象来创建Word文档并保存创建的文档到文件目录下的例子(在新建的控制台程序里添加”Microsoft.Office.Interop.Word 14.0.0.0“ 这个引用,14.0.0.0版本是对应于Office 2010的一个互操作程序集, 12.0.0.0版本则是对应于Office 2007的互操作程序集,如果你电脑中只安装了Office 2007的话,就只能找到 12.0.0.0的版本的,如果安装了Office 2010的话,就可以同时找到这两个版本。)。具体代码如下:

复制代码
using System;
// 添加额外的命名空间
using Microsoft.Office.Interop.Word;

namespace COM互操作性
{
    class Program
    {
        static void Main(string[] args)
        {
            // 调用COM对象来创建Word文档
            CreateWordDocument();
        }

        private static void CreateWordDocument()
        {
            // 启动Word并使Word可见
            Application wordApp = new Application() { Visible = true };

            // 新建Word文档
            wordApp.Documents.Add();
            Document wordDoc = wordApp.ActiveDocument;
            Paragraph para = wordDoc.Paragraphs.Add();
            para.Range.Text = "欢迎你,进入Learning Hard博客";

            // 保存文档
            object filename = @"D:learninghard.doc";
            wordDoc.SaveAs2(filename);

            // 关闭Word
            wordDoc.Close();
            wordApp.Application.Quit();
        }
    }
}
复制代码

运行结果为:
C# 互操作性入门系列(四):在C# 中调用COM组件第3张

此时在所指定的文件目录中就可以看到你刚才创建的Word文档了。通过COM互操作的技术我们可以Office的自动化操作。

三、在C# 中调用COM组件的实现原理剖析

通过上面的例子,大家可以看出在.NET 中调用COM组件是非常方便和简单的,以至于我们根本不能明白它背后的原理的,下面就介绍在托管代码中调用COM组件的实现原理和需要的步骤。

要运行上面的程序必须添加一个互操作程序集——“Microsoft.Office.Interop.Word 14.0.0.0”,大家可以通过下面的步骤来添加这个程序集:

  • 请在“解决方案资源管理器”中,右击引用”文件夹,然后单击添加引用”。
  • “.NET”选项卡上,选中最新版本的Microsoft.Office.Interop.Word例如,“Microsoft.Office.Interop.Excel 14.0.0.0”。单击“确定”。

通过上面添加引用的步骤可以看出,Microsoft.Office.Interop.Word.dll是一个.NET程序集,而不是COM组件,这时候朋友们肯定有这样的疑问——不是调用COM组件的吗?怎么在托管代码中调用.NET 程序集的?这样怎么能算是在.NET下调用COM组件的演示了? 然而事实是——Microsoft.Office.Interop.Word.dll确实是一个.NET程序集,并且它也叫做COM组件的互操作程序集,这个程序集中包含了COM组件中定义的类型的元数据, 托管代码通过调用互操作程序集中公开的接口或对象来间接地调用COM对象和接口的。由于托管代码中不能直接使用COM对象和接口,所以托管代码对COM对象的调用时是通过CLR的COM Interop层作为代理完成的,这个代理就是RCW(即Runtime Callable Wrapper,运行时可调用包装),所以对COM对象的调用,都是通过RCW来完成的,RCW做的工作主要有激活COM对象和在托管代码和非托管代码之间进行数据封送处理(从这里可以看出,RCW就是 .NET平台和COM组件之间的一个代理,微软的很多技术都使用了代理的,例如WCF技术——我们在代码中创建的对象其实只是服务的一个代理,通过代理对象来访问真真的对象的服务,即方法。讲到代理的技术,C#中的委托也是代理的一种实现,此时又想到了23中设计模式中的——代理模式,然而生活中也不乏代理的例子,租房中介,代理服务器等)。下面通过一个图来演示下在.NET中调用COM组件的原理:

C# 互操作性入门系列(四):在C# 中调用COM组件第4张

关于通过Tlblmp.exe工具来生成互操作程序集步骤,这里我就不多详细诉说了,大家可以参考MSDN中这个工具详细使用说明 :http://msdn.microsoft.com/zh-cn/library/tt0cf3sx(v=VS.80).aspx

然而我们也可以使用Visual Studio中内置的支持来完成为COM类型库创建互操作程序集的工作,我们只需要在VS中为.NET 项目添加对应的COM组件的引用,此时VS就会自动将COM类型库中的COM类型库转化为程序集中的元数据,并在项目的Bin目录下生成对于的互操作程序集,所以在VS中添加COM引用,其实最后程序中引用的是互操作程序集,然后通过RCW来对COM组件进行调用。 然而对于Office中的Microsoft.Office.Interop.Wordd.dll,这个程序集也是互操作程序集,但是它又是主互操作程序集,即PIA(Primary Interop Assemblies)。主互操作程序集是一个由供应商提供的唯一的程序集,为了生成主互操作程序集,可以在使用TlbImp命令是打开 /primary 选项。看到这里,朋友们肯定有这样的疑问:PIA与普通程序集到底有什么区别呢?——区别就是PIA除了包含了COM组件定义的数据类型外,还包含了一些特殊的信息,如公钥,COM类型库的提供者等信息。然而 为什么需要主互操作程序集的呢 ? 对于这个问题的答案就是——主互操作程序集可以帮助我们解决部署程序时,引用互操作程序集版本不一致的问题。(如果开发人员会为一个COM组件类型库生成多个互操作程序集,项目中引用的互操作程序集版本与部署时的互操作程序集版本不一致的问题,有了互操作程序集时,我们可以直接引用官方提供主互操作程序集。)

四、错误处理

知道了如何调用COM组件之后,大家或许会问:如果调用COM对象的方法失败时怎么去获取失败的信息呢?对于这个疑问,错误的处理的方法和我们平常托管代码中的处理方式是一样的,下面就具体看看是如何获取错误信息的,下面这段代码的功能是——打开一个现有的Word文档并插入相应的文本,当指定的Word文档不存在时,此时就会出现调用COM对象的Open方法失败的情况,具体代码如下:

复制代码
using System;
using Microsoft.Office.Interop.Word;
using System.IO;
using System.Runtime.InteropServices;

namespace COM互操作中的错误处理
{
    class Program
    {
        static void Main(string[] args)
        {
           // 打开存在的文档插入文本
            string wordPath = @"D:	est.docx";
            OpenWordDocument(wordPath);
            Console.Read();
        }

        // 向现有文档插入文本
        private static void OpenWordDocument(string wordPath)
        {
            // 启动Word 应用程序
            Application wordApp = new Application() { Visible = true };
            Document wordDoc=null;
            try
            {
                // 如果文档不存在时,就会出现调用COM对象失败的情况
                // 打开Word文档
                wordDoc = wordApp.Documents.Open(wordPath);
                // 向Word中插入文本
                Range wordRange = wordDoc.Range(0, 0);
                wordRange.Text = "这是插入的文本";

                // 保存文档
                wordDoc.Save();
            }
            catch(Exception ex)
            {          
                // 获得异常相对应的HRESULT值
                // 因为COM中根据方法返回的HRESULT来判断调用是否成功的
                int HResult = Marshal.GetHRForException(ex);
                // 设置控制台的前景色,即输出文本的颜色
                Console.ForegroundColor = ConsoleColor.Red;
                // 下面把HRESULT值以16进制输出
                Console.WriteLine("调用抛出异常,异常类型为:{0}, HRESULT= 0x{1:x}", ex.GetType().Name, HResult);
                Console.WriteLine("异常信息为:" + ex.Message.Replace('
', ' '));
            }
            finally
            {
                // 关闭文档并
                if (wordDoc != null)
                {
                    wordDoc.Close();
                }
                // 退出Word程序
                wordApp.Quit();
            }
        }
    }
}
复制代码

如果我们D盘中不存在一个 test.docx文档时,此时代码就会进入catch块,输出异常信息,运行结果为:
C# 互操作性入门系列(四):在C# 中调用COM组件第7张

从上面的结果我们看到了一个 HRESULT值,这个值真是COM代码中返回返回的。在COM中,COM方法通过返回HRESULT来报告错误;.NET 方法则通过引发异常来报告错误,为了方便地在托管代码中获得COM代码中出现的错误和异常信息,CLR提供了两者之间的转换,每一个代表错误发生的HRESULT都会被映射到.NET Framework中的一个异常类,对于具体的映射关系可以参考MSDN中 的文章:http://msdn.microsoft.com/zh-cn/library/9ztbc5s1(VS.80).aspx,我这里就不具体用表格列出来的。 如果某个HRESULR不能被映射到等效的.NET Framework 异常类时,那么就会被映射到COMException异常类, 我们可以通过Marshal类的GetHRForException方法来获得异常类对应的HRESULT值(该方法的使用在上面代码中已经贴出)

五、小结

关于在.NET中调用COM组件的介绍就到这里的,即使我们在.NET中调用COM对象的方法是非常的简单和方便,但是理解CLR 为我们背后完成的工作到底有哪些和理解托管代码中调用COM组件原理也是相当有必要的。因为理解了调用的原理之后,当我们出现问题的时候就可以很快找到解决方案并解决它,不会觉得无从下手,这样就可以帮助我们提供解决问题的能力。

免责声明:文章转载自《C# 互操作性入门系列(四):在C# 中调用COM组件》仅用于学习参考。如对内容有疑问,请及时联系本站处理。

上篇局域网永恒之蓝病毒发包的解决方案之二oracle锁下篇

宿迁高防,2C2G15M,22元/月;香港BGP,2C5G5M,25元/月 雨云优惠码:MjYwNzM=

相关文章

纠错《COM技术内幕》之ProgID

最近在看《COM技术内幕》,看到第六章时发现该章节在解释ProgID时有点错误,特此记录一下,也给正在学习COM的小伙伴们一个提示。 而且我发现该问题存在于一些很多大型软件的COM组件中。(开发者估计都是看了该书吧) 在该书的6.3.5章节讲解了ProgID的在注册表中的格式,示例如下 注册表文件格式为 Windows Registry Editor V...

Java之Jacob调用COM接口DLL-----------------------------------dm。dll

用Java控制windows了,嗯,低层次按键模拟,可控制游戏,内存也不在话下。 一、环境介绍 1、myeclipse8.5 2、著名按键插件dm。dll  32bit。此插件实现COM接口,百度百科说是vc6.0编的。 PS:真™坑爹,害我跑去研究jna了。个人觉得是vb编的。 3、jdk1.8 32位。一定要32位,因为免费dm。dll也是32位。 4...

Linux(Ubuntu):搭建GitLab托管代码

GitLab 简介: GitLab 是利用 Ruby on Rails 一个开源的版本管理系统,实现一个自托管的 Git 项目仓库,可通过 Web 界面进行访问公开的或者私人项目。它拥有与 Github 类似的功能,能够浏览源代码,管理缺陷和注释。可以管理团队对仓库的访问,它非常易于浏览提交过的版本并提供一个文件历史库。团队成员可以利用内置的简单聊天程序...

Windows上使用Git托管代码到Coding

作者:荒原之梦 Git简介: Git是一款分布式版本控制系统,可用于项目的版本管理。Git可以管理本地代码仓库与远程代码仓库间的连接以及进行版本控制,使得我们可以在本地离线进行修改等操作,之后再将代码提交到远程代码仓库,方便团队协作。 Git官网: https://git-scm.com/ Git百度百科: https://baike.baidu.co...

进程内COM与进程外COM

1、进程内和进程外Com COM/DCOM 组件可以在DLL 或EXE 文档中实现。 其中在 DLL 中实现的COM/DCOM组件称为 In-Process Server,因为这些组件是加载到使用它们的客户端应用程序执行程序内存之中。因此当应用程序调用COM/DCOM 组件的服务时,就和一般的程序或函数调用一样,非常快速。 在EXE 中实现的COM/DCO...

【转帖】C# DllImport 系统调用使用详解 托管代码的介绍 EntryPoint的使用

1 DLLImport的使用 using System; using System.Runtime.InteropServices; //命名空间 class Example { //用DllImport 导入Win32的MessageBox函数 [DllImport("user32.dll", CharSet = CharSet.Unicode)] p...