简介面向GIS开发者的ArcGISC#二次开发资源包基于ArcEngine与ArcGIS Server组件完整覆盖地图编辑、空间分析、网络分析三类常用功能适合希望从入门迈向实战的初中级工程师也适合作为课程设计或毕业设计的参考模板。压缩包共282个文件以99个C#源文件为核心搭配71个bmp按钮图标、37个resources与37个resx界面资源、18个光标、5个ico图标以及sln、csproj工程结构和exe可执行程序构成一套可直接打开运行的桌面GIS应用示例整体仅911KB下载与部署都很轻量。目前已有431人学习下载。除源码外包内还包含pdb调试符号、数据库文件与初始配置可辅助理解图层管理、要素增删、属性编辑、缓冲区分析和最短路径求解的具体实现让读者从界面交互一路追踪到空间算法底层便于在自有项目中快速复用、改造和排错。1. 一套ArcGISC#二次开发的RAR先从20个BMP读起当我第一次拆开这套ArcGISC#二次开发的源码包时如果没忍住先去翻MainForm准会被一堆BMP文件搞懵。UNDO.BMP、pg_Fix_In.bmp、Pg_Fit.bmp、增加注记.bmp……这些在我眼里其实是整套工具的功能表撤销、定比缩放、全图、注记它们对应的就是ArcEngine桌面工具条上每一个按钮的图标。换句话说这个包不是拿来即跑的完整工程而是一套由ArcGIS Engine和C#组合起来的地图编辑、空间分析、网络分析示例合集。对正在以ArcMap手动操作为主、想转向Engine自定义工具的开发者或者准备搭一套带编辑和分析功能的GIS工具集的人来说按着这张图去对API比抱着对象模型文档硬啃有用得多。2. ArcEngine还是ArcGIS Server开发前先把边界画清楚2.1 三个容易混淆的名字ArcObjects、ArcEngine、ArcGIS Server很多从ArcMap手动操作切入二次开发的人最先被绕晕的就是这三个词。ArcObjects是Esri最底层的COM组件库理论上C、VB、C#都能调用但它不区分桌面端和服务器端直接操作复杂度极高。ArcEngine则是从ArcObjects里裁剪出来、专门面向嵌入式开发者的.NET组件集它把地图显示、几何操作、地理数据库访问封装成一个个DLL你只要在C#工程里添加引用就能用。ArcGIS Server和Engine是两条路线。Server负责把地图文档、地理处理模型发布成REST服务客户端通过URL调用服务端不直接跑你的WinForm代码Engine则是在你的进程里实例化MapControl、FeatureLayer这些对象拿到的是质感完全不同的桌面GIS控制权。这套RAR里出现的是PanZoom.bmp、删除要素.bmp这类按钮图标明显是一个ArcEngine桌面工具集它的特征就是工具栏按钮、图层树控件、编辑会话三件套。我遇到过不少把Server和Engine混着用的项目先在Engine里做编辑再通过Server发布服务给别人查。这不是不行但你要清楚两个体系的许可、对象生命周期、部署方式完全不一样。Engine的许可要绑定代码运行时Server的许可要配在GIS服务器上。选型错了后面全是白干。2.2 从BMP文件名反推一套地图编辑工具的功能清单拿到这套包后我先把所有BMP文件名的英文和拼音读了一遍基本就还原出原作者的界面布局了。这也是我拆别人代码时的习惯先看资源文件再看Form设计器最后才看业务逻辑。下面这张表就是我当时整理的功能映射下载后对照源码会非常容易定位。BMP文件名按钮功能主要接口/类UNDO.BMP撤销上一步编辑操作IEngineEditOperations.UndoEditOperation数据管理_保存数据.bmp保存编辑或导出数据IWorkspaceEdit.StopEditing(true) / IFeatureDataExport简单编辑_删除要素.bmp点击删除要素ITool拾取点 IFeature.Deletepg_Fix_In.bmp定比放大IMapControl.FixExtent / INewEnvelopepg_Fix_Out.bmp定比缩小IMapControl.FixExtentincrease注记.bmp添加文字注记IGraphicsContainer.AddElement(TextElement)PanZoom.bmp平移缩放组合内置Command或自定义IToolPg_NextView.bmp切换下一视图IActiveView.PanFromExtentPg_Fit.bmp全图显示IMapControl.Extent map.FullExtentSave.bmp提交当前编辑IEngineEditor.StopEditing(true)这个包的价值在于BMP文件名把每个功能模块的入口都标出来了。你下载后不必从头看几十个类直接从“简单编辑_删除要素.bmp”这个文件反查它被哪个Tool引用了就能顺藤摸瓜找到删除要素的完整代码路径。2.3 C#工程起步引用、运行时绑定与许可初始化无论你要复刻度哪个功能工程搭建都有固定套路。先说明一下最低必需引用System、Geometry、Geodatabase、Carto、Controls、Display、SpatialAnalyst、NetworkAnalyst前五个是跑地图显示的标配后面两个是按需加的。添加引用之后必须做运行时绑定和许可初始化这段代码我一般直接放在Program.cs的Main入口或者主窗体构造函数里。private void InitArcGISRuntimeAndLicense() { // 适配本机安装的ArcGIS版本10.x必须绑定一次运行时 if (ESRI.ArcGIS.RuntimeManager.ActiveRuntime null) { ESRI.ArcGIS.RuntimeManager.Bind(ESRI.ArcGIS.ProductCode.Engine); } // EngineGeoDB 是能编辑文件/个人地理库的最低许可档 IAoInitialize ao new AoInitializeClass(); esriLicenseProductCode product esriLicenseProductCode.esriLicenseProductCodeEngineGeoDB; if (ao.IsProductCodeAvailable(product) esriLicenseStatus.esriLicenseStatusAvailable) { ao.Initialize(product); } else { throw new ApplicationException(EngineGeoDB许可不可用); } }逻辑说明很简单先绑定运行时时再初始化许可。注意Bind方法的参数取决于你机器装的是Engine还是Desktop如果装了Desktop并且开发调试可以Bind成EngineOrDesktop否则纯Engine环境会抛BadImageFormatException。许可初始化这块我发现很多人掉坑程序启动了界面也出来了但一加载shp就报0x80040206多半就是没初始化许可证。还有一种典型错误是只Bind了运行时没调用AoInitialize功能全灰。这套源码包里如果带了LicenseControl控件它在设计期只是拖了一个控件框架运行时仍然要依赖代码侧许可初始化二者不冲突。3. 地图编辑把手动点一点的活变成工具栏上的ITool3.1 编辑会话的骨架StartEditing、StartEditOperation、StopEditOperationArcEngine做地图编辑核心不是按钮而是“编辑会话”这个状态机。你在ArcMap里手动编辑时其实也是先进入一个编辑会话只是界面把这件事包装成了“开始编辑”。C#里所有增删改都必须发生在编辑会话中否则要素类会直接拒绝你的Store()调用。我一般用IEngineEditor来启动编辑会话因为它的内部维护了一个操作栈能配合UNDO.BMP实现撤销。以下是标准的启动流程。public IEngineEditor BeginEditSession(IFeatureLayer layer, IMap map) { // 从要素类所在的数据集拿到工作空间 IDataset dataset layer.FeatureClass as IDataset; IWorkspace workspace dataset.Workspace; // 一个Map同时只能有一个编辑会话先结束旧的再开新的 IEngineEditor editor new EngineEditorClass(); if (editor.EditState ! esriEngineEditState.esriEngineEditStateNotEditing) { editor.StopEditing(false); } editor.StartEditing(workspace, map); return editor; }逻辑说明IEngineEditor.StartEditing有两个参数第一个是工作空间第二个是你正在编辑的Map对象。之所以传Map是因为编辑器要对图层要素做当前地图范围内的可视化管理而且Undo/Redo操作栈绑定在Map上。StartEditOperation和StopEditOperation是编辑会话里的“事务夹层”每次操作开始和结束都要成对调用。频繁操作但不夹层后果是内存疯涨、撤销栈混乱。如果你在循环里添加100个要素一个迭代用一个Operation最后用户撤销会看到100步如果100个要素放在一个Operation里包起来撤销一次全没了。这个粒度要看你产品要暴露给用户什么。3.2 增删要素的五步拾取、定位、判断类型、执行、清理工具栏上的“简单编辑_删除要素.bmp”对应的核心逻辑归根到底是“鼠标点一下找到命中的要素调Delete()”。实现ITool是最直接的方案。ITool接口和ICommand接口不一样ICommand点一下执行一次ITool则可以持续监听鼠标事件。public void OnMouseDown(int Button, int Shift, int X, int Y) { // 把屏幕坐标转成地图坐标注意要用DisplayTransformation不是直接new一个Point IPoint mapPoint _mapControl.ActiveView.ScreenDisplay.DisplayTransformation .ToMapPoint(X, Y); // 用空间过滤器做点选esriSpatialRelIntersects允许点到线上也命中 ISpatialFilter spatialFilter new SpatialFilterClass { Geometry mapPoint, SpatialRel esriSpatialRelEnum.esriSpatialRelIntersects }; IFeatureCursor cursor _targetLayer.FeatureClass.Search(spatialFilter, false); IFeature feature cursor.NextFeature(); if (feature ! null) { // 删除前必须保证处于一个EditOperation中 _editor.StartEditOperation(); feature.Delete(); _editor.StopEditOperation(); } _mapControl.ActiveView.Refresh(); }这里有几个关键点。坐标转换不能在OnMouseDown里用new IPoint直接赋值因为屏幕坐标到地图坐标依赖当前视图的显示变换直接构造出来的Point在视图变化时会漂移。空间过滤器选esriSpatialRelIntersects而不是Contains是考虑到用户想点选一条很细的线如果要求完全包含鼠标很难命中。删除要素的Search是只读查询所以Search的第二个参数传false表示不需要更新游标。ArcEngine的游标对象在使用完之后的释放问题我放到第5章避坑记录里细说这里先记住不要手动调Marshal.ReleaseComObject。添加要素的逻辑也类似但多了一步给新增要素设置属性值。private void AddPointFeature(IFeatureLayer layer, IPoint location) { // 创建要素前先拉到字段索引避免每次FindField都去遍历字段集合 IFeatureClass featureClass layer.FeatureClass; int nameFieldIndex featureClass.FindField(NAME); _editor.StartEditOperation(); IFeature feature featureClass.CreateFeature(); feature.Shape location; feature.set_Value(nameFieldIndex, 新建点); feature.Store(); _editor.StopEditOperation(); _mapControl.ActiveView.Refresh(); }CreateFeature只是在内存里创建了一个要素行必须调用Store()才会真正写入工作空间。Store()之前给字段赋值如果字段索引取错会直接抛0x80041655字段不存在的异常所以FindField的返回值建议只用一次缓存下来复用。3.3 Undo/Redo与保存数据两个容易踩逻辑陷阱的操作UNDO.BMP对应的功能在IEngineEditor里非常简洁。IEngineEditOperations ops _editor.EditOperations; if (ops.CanUndo) { ops.UndoEditOperation(); _mapControl.ActiveView.Refresh(); } if (ops.CanRedo) { ops.RedoEditOperation(); _mapControl.ActiveView.Refresh(); }这里必须清楚一个概念撤销的是“编辑操作”不是“要素状态”。比如你连续删了两个要素分两次Operation放在栈里撤销一次就恢复第二个撤销两次就全部回来。但如果你把两个Delete放在同一个Operation里撤销一次就同时恢复两个。这个粒度问题没有对错取决于你的交互设计。我习惯是“一次鼠标行为对应一个Operation”因为最符合直觉。保存就一句话_editor.StopEditing(true)。数据管理_保存数据.bmp如果还承担导出功能通常是用IFeatureDataExport把FeatureClass导出成新shp或进地理库这和提交编辑会话是两码事。导出性能并不重要关键是目标坐标系与字段影射不要错我见过导出后字段全部变成FID、Shape的翻车现场那是忘了设置ExportFieldMap。3.4 编辑后的刷新为什么我建议统一走ActiveView.Refresh保存完毕或者每次操作后要让地图显示同步常见做法是调IMapControl.ActiveView.Refresh()。Refresh是对全部图层重绘代价高但稳定。别偷懒用PartialRefresh只刷新某个图层因为编辑会话改的往往不止一个图层隐藏的关联属性也要跟着更新。我在很长一段时间里都在纠结用什么刷新粒度后来养成一个习惯凡是编辑类操作一律全量Refresh凡是查询类高亮才用PartialRefresh精准刷要素。全量Refresh最坏情况是多花几十毫秒但能规避掉图层缓存不更新的玄学问题。这个问题的具体现象和第5章一条坑很像但层次不同那是图层持锁导致崩溃这只是显示不同步。4. 空间分析在C#里的落地好用的不只是Geoprocessing4.1 ITopologicalOperator是几何操作的主入口空间分析被很多人想复杂了以为必须调用Geoprocessing工具。实际上ArcEngine里所有几何级的操作缓冲区、求交、裁剪、合并都收敛在一个接口上ITopologicalOperator。你拿到一个IPoint、IPolyline、IPolygon把它转成ITopologicalOperator就能直接做几何运算不经过GP的重型上下文。最经典的例子是缓冲区分析。public IPolygon CreateBuffer(IGeometry source, double distance) { ITopologicalOperator topo source as ITopologicalOperator; if (topo null) { throw new ArgumentException(输入几何对象不满足拓扑操作要求); } IGeometry bufferGeometry topo.Buffer(distance); return bufferGeometry as IPolygon; }这个方法看着简单但它是空间分析里被复用最多的基元。缓冲区、路网分析和GIS制图中的“沿路生成一定范围”都用它做底子。Buffer方法唯一参数是距离但这个距离的单位极容易踩坑我放在下面单独讲。4.2 缓冲区分析的参数化距离单位、融合与坐标系Buffer距离的单位就是输入几何所在坐标系的单位不会自动换算。如果输入的要素类坐标是WGS84经纬度你传一个100进去它生成的是100度缓冲区不是100米。这个坑在初学者里出现概率极高。正确做法是先把几何投影到当地投影坐标系再算Buffer。我给个我常用的流程。public IPolygon BufferInMeters(IGeometry source, double meters) { // 选定一个项目所在区域的高斯-克吕格投影示例用CGCS2000 3度分带中央经线114 ISpatialReferenceFactory srFactory new SpatialReferenceEnvironmentClass(); IProjectedCoordinateSystem targetProjection srFactory.CreateProjectedCoordinateSystem( (int)esriSRProjCS4Type.esriSRProjCS_Xian1980_3_Degree_GK_Zone_39_DM); IGeometry projectedSource source.Project(targetProjection) as IGeometry; ITopologicalOperator topo projectedSource as ITopologicalOperator; IGeometry bufferGeom topo.Buffer(meters); return bufferGeom as IPolygon; }逻辑说明Project返回的是一个新的几何对象不会修改原对象。使用新的投影坐标系后Buffer距离就可以放心用米了。如果你的数据是地理坐标系又想保留原始数据不动就在内存里做投影输出结果再Project回去。融合问题也要注意。多个相邻要素的Buffer如果只是简单地相加中间会存在重叠区。遇到“建一个覆盖所有道路两侧50米的范围”这种需求时要把所有Buffer结果装进一个IGeometryCollection里再调用ITopologicalOperator.Union()做几何合并。4.3 叠置分析的两种切法对象模型与GP工具的区别叠置分析是空间分析的另一个高频场景。比如“计算新建小区的影响范围是否与生态红线重叠”或者“找出某条输电线路经过哪些村庄行政区”这类操作的本质就是几何求交。对象模型里的写法如下。public IGeometry Intersect(IGeometry geomA, IGeometry geomB) { ITopologicalOperator topo geomA as ITopologicalOperator; IGeometry result topo.Intersect(geomB, esriGeometryDimension.esriGeometry2Dimension); return result; }第二个参数esriGeometry2Dimension指保证金交结果保留二维面信息不降维成点或线。如果是线和线相交要交点就传esriGeometry0Dimension。这个选择直接影响结果类型选错的话后面拿到的Geometry可能无法转成IPolygon。GP工具和对象模型的取舍我整理成一张对比表日常开发时按这张表选方案就够了。对比维度Geoprocessing工具ITopologicalOperator上手成本低参数用字符串传入中等先理解几何类型执行性能低每次都要构造和分析上下文高纯内存几何运算可调试性差错误信息要靠工具日志好直接断点看几何对象大批量处理不适合在循环里调适合循环内高频调用我的原则是原型验证、跨数据源转换用GP生产环境的实时交互分析用ITopologicalOperator。GP每调用一次都有初始化成本循环里调200次缓冲区性能差距就可能到秒级。4.4 空间分析的坐标系统一不动这一层再准也白算前面两个小节的代码里都涉及坐标系这里专门强调一下顶层原则参与一个分析过程的所有图层空间参考必须一致。ArcMap手动操作时软件默认开启了“地图坐标投影转换”两个不同投影的图层叠加在一起看上去是重合的但后台存储的坐标值仍然各自为政。如果你在C#里直接拿两个要素做Intersect不统一SpatialReference得到的结果就是废的。我给项目里定过一个规矩在分析入口处强制统一坐标系。具体做法是先设定一个目标坐标系统然后逐个图层做ProjectProject失败就抛异常中断不做静默容错。这套流程后来一次空间分析的坐标错乱都没再出过。5. 避坑记录ArcEngine里我踩过的5个真坑5.1 图层不刷新旧要素赖在视图上现象删除一个要素后代码执行了Delete()数据源里确实少了但界面上的要素还在要拖拽一下地图或者切换缩放级别才消失。原因只操作了数据没有告诉视图重绘。或者用了PartialRefresh刷新错了图层ArcEngine的PartialRefresh需要精确区分图层索引一旦图层的添加顺序变了刷新范围就指错了。解决编辑类操作统一走IMapControl.ActiveView.Refresh()全量刷新。虽然多花一点性能但不用维护图层顺序和刷新区域。查询高亮才用PartialRefresh。从那以后我的编辑工具再也没有出现幽灵要素。5.2 手动ReleaseComObject反而容易出访问冲突现象程序运行一段时间后客户会报一个AccessViolationException日志指向的代码行不固定有时是游标有时是几何对象。崩溃前内存占用显示还在上涨。原因ArcEngine是COM互操作很多程序员习惯在每次使用后Marshal.ReleaseComObject去释放游标和要素。但这套API的引用计数管理很微妙同一个接口对象可能被多个内部对象引用你强行release一个别的模块还持有引用访问就崩了。解决在.NET环境里不要主动ReleaseComObject。让垃圾回收器接管最多在循环处理大量要素时用Marshal.FinalReleaseComObject兜底。我后来干脆写了规则凡是碰COM对象一律等函数出作用域释放不再手动介入崩溃率直线下降。5.3 许可初始化失败界面正常但功能全灰现象程序能启动MapControl也能加载地图但所有编辑按钮都是灰色点击没有反应。查看日志发现抛了0x80040206许可证未初始化。原因RuntimeManager.Bind只负责绑定运行时IsProductCodeAvailable和Initialize才是申请许可的入口。很多人只Bind没Initialize尤其在把代码从ArcMap插件迁移到独立Engine应用时最容易漏掉。解决按第2章的代码在Main入口处先Bind再Initialize并且确保申请的许可是EngineGeoDB或更高档。注意如果你同时装了Desktop和Engine产品代码要仲裁我一般统一用EngineOrDesktop来避免开发机许可冲突。5.4 中文注记变成方块或问号现象用TextElement添加中文注记地图上显示出来是一排方块数据源编码一看是GBK换成UTF-8再试还是乱码。原因ArcEngine 10.x的TextElement在显示时依赖字体渲染如果当前图层环境没有匹配中文字符的符号库就退化成方块。这和字符串编码没有直接关系你把字符串换成英文就正常说明编码根本没初始化问题。解决在创建TextElement时显式设置font大小和字形为“宋体”或“微软雅黑”并在添加前调用textElement.ScaleText true之类的渲染属性。如果还是乱码检查地图文档的字体替换规则在Map属性里把缺失字体映射到黑体。这套组合拳基本能根治中文注记显示。5.5 坐标系不一致缓冲区结果漂到海里去现象对某城市点要素做缓冲区算出来的圆跑到几百公里以外的海面上或者范围大得离谱完全不在图层附近。原因数据是WGS84经纬度但Buffer传了一个5000当作5000米。5000度的弧长已经绕地球半圈了。还有一种可能是源几何SpatialReference为空Project时抛异常没捕获分析继续在错误对象上执行。解决在入口处强制检查几何SpatialReference为空就手工赋予。Buffer的单位这个坑我已经写在参数说明里最近维护的老项目也出现过一次翻日志发现是把英里当米用了。从那以后凡是空间分析代码参数单位都写注释贴在方法签名上。6. 网络分析从数据准备到性能预热把求路径做成稳定的功能6.1 网络数据集路网从“一串线”变成“可通行图”的关键网络分析在ArcGIS里和前面所有章节的功能都不一样因为它不直接操作要素几何而是操作“网络数据集”。一份shp路网文件只是一堆线段没有拓扑关系网络分析无从谈起。需要先建网再构建连通性让软件知道哪些线在节点处能转弯、能不能掉头、有没有单行限制。这步在ArcCatalog里手动做都不轻松更别说程序化构建。程序化构建NetworkDataset的逻辑比较复杂涉及边要素、节点要素、转弯要素三类对象和连通性规则。我不建议在C#里用代码一条条生成网络数据集除非你的路网数据定期由某个系统批量更新。稳妥做法是在ArcCatalog里手工构建一次之后在C#里只读取。读取的代码反而简单。public INetworkDataset LoadNetworkDataset(IWorkspace workspace, string name) { // OpenNetworkDataset方法要求workspace接口是IWorkspace2 IWorkspace2 workspace2 workspace as IWorkspace2; INetworkDataset networkDataset workspace2.OpenNetworkDataset(name); return networkDataset; }影响网络分析结果的大部分因素不在代码而在路网数据本身。我见过很多项目“最短路径算出来不是最优”最后查出来是路网没有维护单行线字段方向字段缺失导致双向都按可走算。这类问题用代码解决不了必须在数据层去治理。6.2 最短路径的C#调用优先用现成工具验证再写对象模型网络分析的对象模型很长围绕NARouteSolver、NAContext、NALayer三个核心类展开还要设置停靠点输入、分析设置、结果输出。初学者直接对着对象模型文档上最常见的翻车是参数一多不知道哪个设置没生效最后算出来的路径完全不符合预期。我常用的方法分两步。先用ArcToolbox里的网络分析工具手算一遍确认路网和分析参数都没问题再在C#里复现同样参数。对象模型这一步绕不开但节奏很重要先在ArcMap里确定正确答案代码只是把答案“变成程序自动化”。如果跳过人工验证直接上代码出了问题你根本说不清是数据问题还是参数问题调一整天也找不着原因。6.3 预热与缓存把网络分析从玄学变科学的两个习惯网络分析性能表现非常不稳定同样的路网第一次求解要3秒第二次只要0.3秒。这是网络数据集缓存的内部分级机制在起作用第一次求解时它在做索引和内存加载。如果你把这个过程放进用户交互的按钮事件里用户会明显感觉到第一次“卡了一下”。两个习惯可以有效缓解。第一个是应用启动后做一次网络数据集合法性检查提前把它加载进缓存。第二个是在分析时使用自定义的NALayer避免每次创建默认图层带来的额外开销。public void WarmUpNetworkDataset(INetworkDataset networkDataset) { // 主动触发一次网络数据集的内部索引构建 INetworkCollection networkCollection new NetworkCollectionClass(); networkCollection.SetNetworkDataset(networkDataset); // 只做一次最短路径的热身查询不用关心结果 IFeatureClass dummySource networkCollection.Sources[0] as IFeatureClass; IFeatureCursor cursor dummySource.Search(null, false); while (cursor.NextFeature() ! null) { } }逻辑说明预热的核心是让网络数据集完成内部索引缓冲。调用SetNetworkDataset后再执行一次游标全扫描让数据从磁盘读进内存。后续真正的路径分析就不受冷启动拖累。从那以后我每次接到网络分析相关需求都强制自己按这套流程走一遍先理路网数据质量再ArcMap手算验证最后才写C#代码算完再测一次预热前后的耗时差。这个习惯帮我避开了至少三个看起来像“玄学”的性能问题。希望帮到你。本文还有配套的精品资源点击获取