Bentley二次开发教程01-前言
概述
Bentley（奔特力）是一家总部位于美国费城、拥有3500多名员工、分布在世界80多个办公室、年收入7亿多美金的专注于基础设施软件开发的工程软件有限公司。基础设施领域包括公路、桥梁、机场、摩天大楼、工业厂房和电厂以及公用事业网络等。Bentley 在基础设施资产的整个生命周期内针对不同的职业，包括工程师、建筑师、规划师、承包商、制造商、IT 管理员、运营商和维护工程师的需求提供量身定制的解决方案。这些专业人士将在基础设施资产的生命周期内使用这些资产从事相关的工作。每个解决方案均由构建在一个开放平台上的集成应用程序和服务组成，旨在确保各工作流程和项目团队成员之间的信息共享，从而实现数据互用性和协同工作。
MicroStation软件是Bentley公司的旗舰产品，其前身是在工作站上运行的IGDS（Interactive Graphics Design System）系统，微机出现后Bentley公司创始人Keith Bentley将IGDS软件移植到了微机上，故名MicroStation（微工作站）。所以，MicroStation从一诞生就具有完善的体系架构，其图形工作性能远超同类软件。
Bentley 的设计应用软件体系
Bentley公司的设计软件有数百款，从规划设计到施工建造，再到最后的运行维护，涵盖一个工程的整个BIM生命周期。
Bentley软件还可按行业构成解决方案。下图列出了主要的基础施设行业可用的Bentley软件的组合。比如，供道路行业使用的软件主要有OpenRoads、OpenBridge、OpenSite、LEAP、gINT、SITEOPS、Descartes、OpenCities Map、ContextCapture、LumenRT等等。
但从开发的角度来讲一般分为两种：平台软件和专业软件，MicroStation就是Bentley的基础图形平台软件。它完全基于三维设计，内含实体建模、B样条曲面建模和网格建模三大三维图形内核，能兼容其他各种图形平台导入的数据格式。同时，MicroStation还是一个从二维绘图、三维建模、图形渲染一直到动画制作一体化的图形平台。一款软件在手，各种设计工作尽有。除了MicroStation以外，Bentley还有一个ProjectWise和AssetWise两大平台以及正在蓬勃发展的基于云的用于数字孪生的iTwins平台。
在专业软件方面我们有Open系列设计软件，比如OpenRoads Designer（简称ORD）、OpenRail Designer、OpenBridge Modeler、OpenSite Designer、OpenBuilding Designer（简称OBD）、OpenPlant Modeler（简称OPM）等。还有大量的分析计算软件，如著名的STAAD.Pro、SACS、Haestad系统等。下图内核就是MicroStation，中层就是Open系列设计软件，最外层是大量的分析和模拟类软件。
要想更完整地了解Bentley公司的软件信息，请直接访问Bentley官网：www.bentley.com
中文版网站为：www.bentley.com/zh
Bentley 软件二次开发的意义
虽然Bentley公司已经为我们提供了几乎覆盖各个专业的设计软件，但产业这些软件都是国际通用的，在应用到具体的中国设计场景时就不一定完全适合了。在和大量Bentley用户的交流中，大家都会提到一个“最后一公里（Last Mile）”的问题，就是在应用国外软件到中国的现实场景时总是感觉不能像国内一些软件那样拿来就用，点两下就能出结果。其原因就是这些国际通用软件不可能也不会专门针对中国用户的使用场景和使用习惯来设计，而是要顾及各个国家用户的使用情况的。而这也是我们做软件二次开发的切入点所在。MicroStation平台软件以及其上的许多专业设计软件都提供有专门的软件开发包（简称SDK），利用SDK就能开发出符合具体用户的更贴切的工具甚至软件系统。用户在使用这些二次开发的工具和软件时会感觉比使用原始工具效率更高，同时也能节省用户使用原生软件的时间，从而在两个方面为用户节省时间和金钱。
另外，二次开发包还会给我们提供一些软件本身工具中没有的功能，比如，生成Mesh元素时可指定每个顶点的颜色，通过编程可生成如下这样的彩色四面体和任意形状的体：
利用该特性，我们还能很容易地开发出用彩色Mesh体来表达物体应力分布或受热分布等。
Bentley 的开发体系
虽然Bentley的应用软件有很多，但主流的用于设计方面的应用软件大都是基于平台软件MicroStation开发的，因此对于开发者来说在平台层大家都是互联互通的，而在专业软件层面，Bentley最近几年也是大力地发展开放原则，所以大家也看到了很多的专业软件都是以Open开头的。
下面以OpenBuilding Designer（OBD）为例说明专业软件和平台软件开发的关系。
上图中我们列有MicroStation SDK和OBD SDK，它们是两个独立的软件安装包。如果您只开发在MicroStation中运行的程序，当然除了安装MicroStation外只需要安装MicroStation SDK即可。如果要基于OBD做开发，可安装OBD SDK，其实OBD SDK中含有MicroStation SDK。在OBD二次开发程序中您既可以通过OBD SDK去访问DGN文件中的OBD专用对象（比如梁板柱、墙、门窗等），还可以通过MicroStation SDK去访问DGN文件中的通用对象（比如文字、标注、普通的几何体等）。在OBD SDK中有BuildingElemHandle用来表达OBD专用对象，而在MicroStation SDK中则有ElementHandle来表达通用对象。
接下来以MicroStation为例介绍Bentley设计软件支持的几种开发语言：VBA、C#和C++。下表列出了这三种开发语言的优劣。
|
开发语言
|
所需环境
|
优点
|
缺点
|
|
MicroStation VBA
|
仅需安装MicroStation
|
简单易学
|
API不全，不适合开发大型程序
|
|
C#或VB.NET或C++/CLI
|
MicroStation+Visual Studio
|
C#语言相对于C++来说更简单，可用WinForm或WPF定义界面
|
还未封装完全，一些旧的功能未提供
|
|
C++
|
MicroStation+Visual Studio+SDK
|
功能最完善，性能最好。供C++调用的API被充分验证过。
|
掌握起来有难度，尤其需要学习.r文件来定义界面
|
其中C#或VB.NET是纯托管类代码，必须依赖微软的.NET Framework（框架）来运行，而C++则是纯非托管代码，它只依赖Windows内核就可运行。而C++/CLI则是介于两者之间的一种开发语言，它可以方便地同时访问托管对象和非托管对象。但C++/CLI语言的学习难度也是最大的。曾有一个给几种语言打分的比喻，如果C#的学习难度是5分的话，则C++为20分，而C++/CLI为100分。无论采用哪种语言，我们学习MicroStation开发的关键在于掌握MicroStation API（应用程序接口），而要充分理解每个API函数及其参数的含义，则需要我们对MicroStation软件本身的基本概念有清晰正确的理解。
Bentley 的开发资源
要学习Bentley软件的开发，第一手资料还是软件的SDK。比如，要做MicroStation开发的话，最好要安装MicroStation SDK（注：其实不安装MicroStation SDK也能进行MicroStation的C#开发），这样可以有多个chm格式的开发文档，多个开发例子供参考。除了SDK外，我们还有中文的中国优先社区、中文的BDN社区以及开发服务。下面分述这些内容。
中国优先
2014年8月启用的中国优先社区（www.bentley.com/chinafirst）是基于Bentley的Communities网站建立的。它以全中文的内容专门为中国用户服务。中国优先社区内分Wiki（威客）、Forum（论坛）、Blog（博客）、Files（文件）四大板块。Wiki下有Bentley中文技术资料库，下面按软件名称分类，主要是各软件的使用技巧。在MicroStation板块下有二次开发子版块如下图所示：
其中的一步步学习MicroStation CE Addin开发是您入门学习MicroStation C#开发的推荐资料。如果您在开发过程中遇到问题，可以到Forum板块下的二次开发子版块下搜索您的问题，该子版块下已经累积了五千多个帖子，您的问题很可能会在此找到答案。如果无法找到答案的话，可发帖提问，我们确保工作日内一定会有回复的。
Blog板块会不定期发布一些消息，您可以关注它以了解Bentley产品的最新动态。Files板块用于存放一些较大的下载资料。访问所有这些服务都是完全免费的，只需要您注册一个免费账号或用已经存在的CONNECTION Client账号登录即可。