★ FEATURED ARTICLE 简介ArcGIS EngineESRI官方代码C#开发学习资料包面向希望用C#/.NET进行GIS二次开发的初中级开发者。内容围绕基于C#的GIS应用实践展开覆盖ArcGIS Engine组件安装与配置、地图创建、图层管理、符号渲染、空间查询、几何对象操作、地理编码、服务发布、界面定制及性能调优等知识点并提供城市规划、应急响应等案例参考适合从入门到编写桌面/WebGIS程序的学习路线。压缩包共482个文件、4.18MB以cs源码工程为主同时包含DLL与PDB编译产物、地图缓存cache、位图图标、地理数据库gdb及其索引文件等便于直接对照源码查看工程结构并理解运行机制。资源已有648人学习下载。仔细研读这批ESRI官方风格的示例代码可快速掌握MapControl、GeometryEngine等核心组件的调用方式理解C#事件驱动与ArcObjects交互原理也能借鉴其图层加载、空间分析、服务共享等实际写法少走弯路。1. 为什么到现在还有人坚持用 ArcGIS Engine 做桌面 GIS 开发当所有人都涌向 Web GIS 和三维引擎时ArcGIS Engine 依然被不少老牌 GIS 项目绑得死死的。它不是一个几分钟就能上手的框架而是 ESRI 提供的组件式 GIS 开发库允许你用 C# 在 Windows 桌面上拼装出具备地图显示、空间查询、编辑、符号化甚至 Geodatabase 读写能力的独立程序。你不需要安装整个 ArcGIS Desktop只需要 Engine 运行时和 SDK 就能把地理处理能力嵌进自己的业务系统。这个方向特别适合需要离线作业、用户体验高度定制、或者必须直连企业级空间数据库的桌面工具国土、测绘、管网、电力行业里这类存量项目相当多。就算今天 Web GIS 再热闹本地抓取矢量数据、跑空间分析、批量改字段这套手艺依然有大量实际需求而 ESRI 官方代码和示例正是入门最快的路径。2. 搭建 ArcGIS Engine 开发环境官方代码到底该看哪里2.1 先分清 Engine 与 Desktop开发库选型的第一道坎新手最容易犯的错是把 ArcGIS Engine 等同于 ArcMap 的可编程版本。实际上Desktop 是一个完整应用程序你打开就能用而 Engine 是一套可再分发的 ArcObjects 组件包需要你自行开发界面和逻辑。选型时如果项目只是内部办公、对界面要求不高可以考虑 Desktop 加插件开发但如果要做成交付给客户的独立桌面产品或者需要把 GIS 能力嵌入到已有的 CRM、ERP 系统里Engine 才是正确路径。Engine 的开发模式有两种常见做法一种是纯代码方式直接用 C# 引用 ESRI.ArcGIS 程序集手动创建 MapControl、PageLayoutControl 等控件另一种是在 Visual Studio 里把 Engine 提供的控件拖到窗体上然后通过 SDK 生成的互操作类去操作。我一般倾向于第二种因为 ActiveX 控件在窗体上可以直接看到地图效果调试起来直观得多。但要注意无论哪种做法开发机上除了安装 Engine SDK还需要配置许可服务否则代码一运行就卡在许可校验这一步。2.2 装好 SDK 之后用 ESRI 官方 C# 示例把环境“跑通”官方代码在哪里找安装 ArcObjects SDK for .NET Framework 之后本机帮助文档会附带大量 C# 示例帮助文档里有索引、搜索和示例工程。这些示例覆盖了从最开始的 MapControl 加载地图到 Geodatabase 关系类、拓扑、网络分析等深层功能。ESRI 官方在帮助文档的 “Samples” 部分给出了配套代码我自己的习惯是先把示例工程编译一遍而不是直接抄进自己的项目。编译能通过说明 SDK 环境、许可、引用路径都对了后面自己写代码时才不会遇到莫名其妙的类型找不到错误。先别急着写业务功能第一步先跑一个最简的许可初始化。有一点是几乎所有 Engine 程序都必须做的绑定运行库并检查许可状态。下面这段是典型代码using ESRI.ArcGIS; using ESRI.ArcGIS.esriSystem; public static bool InitLicense() { if (!RuntimeManager.Bind(ProductCode.EngineOrDesktop)) { return false; } IAoInitialize aoInit new AoInitializeClass(); esriLicenseStatus status aoInit.Initialize(esriLicenseProductCode.esriLicenseProductCodeEngineGeoDB); return status esriLicenseStatus.esriLicenseCheckedOut; }这段代码的作用是告诉 ArcGIS 运行库当前程序要用 Engine 或者 Desktop 的许可模式。RuntimeManager.Bind是业务程序启动后的第一行代码漏掉它后续创建 GIS 对象会直接抛异常。AoInitialize.Initialize负责从许可服务器或本地许可文件中取出一个 Engine 许可esriLicenseProductCodeEngineGeoDB是可操作 Geodatabase 的引擎许可如果你想做得更简单也可以用esriLicenseProductCodeEngine。需要注意Initialize返回的不一定是esriLicenseCheckedOut也可能是esriLicenseAlreadyInitialized等状态我的习惯是先把返回状态打日志再决定要不要终止程序。3. 把第一张地图画出来MapControl 与图层加载的最小代码3.1 License 初始化所有功能生效的前置条件很多人的第一道坎是写完 License 初始化后依然报“未找到许可”或“控件初始化失败”。这通常是因为初始化代码的执行顺序不对。License 初始化必须在任何ESRI.ArcGIS控件放到窗体上之前完成。在Form_Load事件里先调InitLicense()再设置 MapControl 的属性顺序绝不能反。还有一种隐蔽情况是 Visual Studio 的设计器会自动创建控件实例如果设计时没有许可设计器也会报错这时候需要在设计模式下先手工临时初始化或者干脆用纯代码方式加载 MapControl这是可行的替代方案。下面是一个纯代码方式创建 MapControl 的最小例子这样就不用依赖工具箱拖拽ESRI.ArcGIS.Controls.MapControl mapControl new ESRI.ArcGIS.Controls.MapControl(); mapControl.Dock DockStyle.Fill; this.Controls.Add(mapControl); IMap map mapControl.Map; map.SpatialReference ESRI.ArcGIS.Geometry.SpatialReferenceEnvironment.CreateProjectedCoordinateSystem(0);注意MapControl默认会有一个初始化好的空 Map 对象不需要你去 new。SpatialReference建议显式设置否则后续加载的图层如果空间参考不一致会引发显示位置偏移和查询不到数据的怪问题。这里0代表 Web Mercator 投影坐标系SpatialReferenceEnvironment是创建空间参考的标准入口日常开发你还会频繁用到它。3.2 用代码加载 Shapefile 并添加到地图加载矢量数据是 GIS 开发里最基础的动作。在 Engine 里你可以通过IWorkspaceFactory打开一个文件夹然后用IFeatureWorkspace获取 FeatureClass再包装成FeatureLayer添加到地图。下面是加载一个 Shapefile 的完整逻辑using ESRI.ArcGIS.Geodatabase; using ESRI.ArcGIS.Carto; public void LoadShapefile(string filePath) { var path System.IO.Path.GetDirectoryName(filePath); var name System.IO.Path.GetFileNameWithoutExtension(filePath); IWorkspaceFactory factory new ShapefileWorkspaceFactoryClass(); IFeatureWorkspace workspace factory.OpenFromFile(path, 0) as IFeatureWorkspace; IFeatureClass featureClass workspace.OpenFeatureClass(name); IFeatureLayer featureLayer new FeatureLayerClass(); featureLayer.FeatureClass featureClass; featureLayer.Name featureClass.AliasName; mapControl.Map.AddLayer(featureLayer); mapControl.Map.ClearLayers(); // 如果不想覆盖之前的图层注释掉这行 mapControl.ActiveView.Refresh(); }这段代码有两个容易被忽略的点。第一OpenFromFile接收的是目录路径而不是文件路径很多人把filePath直接传进去结果返回COMException。第二FeatureLayer.Name如果不设置默认可能与 FeatureClass 类名不一致图例上会显示成空或乱码。另外AliasName有时候为空所以我一般会做一个判断为空时直接用featureClass.Name。图层加载完成后Refresh必须调用否则地图区域显示不出来。这里的ClearLayers()是给你做一个清理动作实际项目里我会先查一下MapControl.Map.LayerCount做增量添加而不是每次全清。4. 日常开发里逃不掉的三类 GIS 操作查询、编辑、符号化4.1 属性查询与字段计算器用 C# 写一个“批量改字段”工具属性查询是 GIS 字段计算器最常见的后台实现方式。在 ArcGIS Engine 里IQueryFilter负责的只是 SQL 过滤条件真正执行查询的是IFeatureClass.Search。一个非常容易搞错的地方是Search方法返回的不是要素列表而是一个游标IFeatureCursor你必须循环调用NextFeature()来拿数据。访问字段值时可以使用IFeature.Value[字段索引]也可以用Fields.FindField(字段名)获得索引。下面是一个批量更新字段的代码模拟把人口字段POP为空值的记录改成 0public void BatchUpdatePopup(string layerName) { IFeatureLayer featureLayer GetLayer(layerName); IFeatureClass fc featureLayer.FeatureClass; IQueryFilter qf new QueryFilterClass(); qf.WhereClause POP IS NULL; IFeatureCursor cursor fc.Search(qf, true); IFeature feature; while ((feature cursor.NextFeature()) ! null) { int index feature.Fields.FindField(POP); feature.set_Value(index, 0); feature.Store(); } System.Runtime.InteropServices.Marshal.ReleaseComObject(cursor); }fc.Search(qf, true)第二个参数recycling很关键。设置为true游标每次返回的都是同一个要素对象内存开销低适合只读场景但如果你想把每个feature存到 List 里必须设置false否则所有引用都指向同一个对象取出来的数据全是最后一条。这一点简直是 GIS 开发里的玄学翻车现场我见过不少人因为用true存列表导致数据混乱。另外feature.Store()是逐条保存如果字段量大、要素多性能不够好。更专业的做法是用IFeatureCursor.UpdateFeature把游标先通过fc.Update(qf, false)建立然后调用cursor.UpdateFeature(feature)这样避免了每次Store的重复解析。我在实际项目里习惯用后一种批量编辑数据时可以快两三倍。4.2 空间查询如何按范围选出要素并统计面积空间查询相比属性查询更复杂一点因为需要构造一个几何对象再用ISpatialFilter定义空间关系。最常见的需求是给定一个多边形选出与其相交的所有地块然后统计面积。这里需要把几何对象当作查询条件空间关系设置为esriSpatialRelIntersects。还需要注意坐标系匹配如果几何对象是地理坐标而图层是投影坐标查询结果往往为空。来看一段执行空间查询并统计面积的代码public double SummarizeArea(IGeometry selectionGeometry) { IFeatureLayer layer GetLayer(parcel); IFeatureClass fc layer.FeatureClass; ISpatialFilter sf new SpatialFilterClass(); sf.Geometry selectionGeometry; sf.GeometryField fc.ShapeFieldName; sf.SpatialRel esriSpatialRelEnum.esriSpatialRelIntersects; IFeatureCursor cursor fc.Search(sf, true); IFeature feature; double totalArea 0; while ((feature cursor.NextFeature()) ! null) { IArea area feature.Shape as IArea; if (area ! null) { totalArea area.Area; } } return totalArea; }sf.GeometryField必须赋值否则部分数据源会报错。esriSpatialRelIntersects是“相交即选中”包含边界相交和完全包含。想要矩形框选一般用esriSpatialRelEnvelopeIntersects效率会更高因为空间索引利用得更彻底。IArea是面积接口注意多边形可能有多个环Area属性会自动计算环的面积差这就是为什么用一个接口就能正确处理带岛多边形的原因。统计面积时还要注意如果要素的坐标系是经纬度Area返回的是平方度没有什么实际意义需要先做投影转换。4.3 符号化用唯一值渲染器让图层一眼可读开发 GIS 工具时数据的可视化往往决定用户是否愿意用。ArcGIS Engine 里符号化的核心是IRenderer具体到分类显示最常用的是IUniqueValueRenderer。它能够根据一个字段的值自动生成不同颜色的符号比如按土地用途分类显示地块。public void ApplyUniqueRenderer(IFeatureLayer layer, string fieldName) { IGeoFeatureLayer geoLayer layer as IGeoFeatureLayer; IUniqueValueRenderer renderer new UniqueValueRendererClass(); renderer.FieldCount 1; renderer.set_Field(0, fieldName); renderer.DefaultSymbol new SimpleFillSymbolClass() as ISymbol; IFeatureClass fc layer.FeatureClass; IQueryFilter qf new QueryFilterClass(); qf.WhereClause ${fieldName} IS NOT NULL; IFeatureCursor cursor fc.Search(qf, true); IFeature feature; var seenValues new HashSetstring(); while ((feature cursor.NextFeature()) ! null) { object val feature.get_Value(feature.Fields.FindField(fieldName)); string key val?.ToString() ?? 空; if (!seenValues.Contains(key)) { seenValues.Add(key); renderer.AddCategory(key, new SimpleFillSymbolClass() as ISymbol); } } geoLayer.Renderer renderer; }这里没有给每个类别区分颜色因为真实项目中你会从色带或者颜色栈里逐个分配我建议先按唯一值数量准备好ColorRamp再用IColorRamp去生成颜色。一个常见错误是renderer.AddCategory时漏掉FieldCount设置导致运行时抛异常。另外如果要素类数据量特别大Search的时候建议只查需要的字段不要Search所有字段否则符号化会非常慢。可以设置qf.SubFields fieldName只检索这一个字段游标性能会好很多。5. 开发踩坑与排查那些让 ArcGIS Engine 项目延期的关键细节5.1 许可初始化失败执行顺序与产品码的坑现象程序启动后抛出ESRI.ArcGIS.RuntimeManager未绑定或者LicensedProduct: ArcGIS Engine报错。原因最常见的是RuntimeManager.Bind没有在程序入口最先执行或者绑定参数与实际安装的运行时不一致。比如你装了 ArcGIS Desktop却绑定ProductCode.Engine或者反过来。解决在Main方法或者Form构造函数的第一行绑定ProductCode.EngineOrDesktop这是一个兼容项能同时覆盖桌面和 Engine 环境。然后再调用AoInitialize并且不要忽略返回值。注意如果你的程序同时启动多个窗体只需初始化一次不要重复调用否则可能会耗尽许可。5.2 COM 对象释放的玄学现象程序运行一段时间后内存飙升或者偶尔出现“尝试读取或写入受保护的内存”的异常。原因ArcGIS Engine 的对象大多是 COM 对象没有及时释放句柄GC 又无法自动回收所有 COM 资源。解决我用的是两个办法。第一所有游标对象在finally里用Marshal.ReleaseComObject配合null赋值第二大块几何操作完成后调用System.Runtime.InteropServices.Marshal.FinalReleaseComObject。但注意不要对MapControl和Map对象过度释放这些对象由控件托管手动释放会造成悬挂引用。我的经验是优先释放游标、操作返回的临时对象不要释放你在窗体上一直使用的对象。5.3 32 位和 64 位混用的崩溃现象在开发机上运行好好的程序部署到客户电脑上报“未能加载文件或程序集”或者地图控件一片空白。原因ArcGIS Engine 10.x 分 32 位和 64 位版本。如果你的程序集目标是AnyCPU生成的进程在 64 位系统上会是 64 位但引用的许多 COM 组件还是 32 位两边不匹配就会失败。解决把项目的平台目标强制设为x86大多数项目如此或者安装对应的 64 位 Runtime。我一般统一用x86因为很多第三方控件只提供 32 位版本。部署前我会把客户机的 ArcGIS Engine Runtime 版本号和开发机核对一遍差一个小版本都容易出问题。5.4 空间参考不匹配导致查询结果为空现象属性查询有数据空间查询永远返回 0 条记录。原因传入的几何对象空间参考和图层 FeatureClass 的空间参考不一致。例如快速用Geometry.Envelope构造一个矩形但没有给几何设置空间参考几何默认为未知查询时匹配失败。解决在构造ISpatialFilter.Geometry之前用几何对象的SpatialReference属性或者通过Geometry对象的投影方法先把几何投影到图层的空间参考。常见做法是先拿到图层的SpatialReference然后Geometry.Project(spatialRef)。最稳妥的方式是给每个几何对象显式设置空间参考并在查询前检查Geometry.SpatialReference和FeatureClass.ShapeField.SpatialReference是否相等。5.5 字段计算器更新失败游标和 editing session 的关系现象逐条feature.Store()时抛Exception from HRESULT: 0x80040204。原因对于 File Geodatabase 或 SDE 数据源逐条更新时如果不是在编辑会话里执行数据库锁冲突会导致更新失败。解决对 SDE 或企业级数据库操作前先启动IEdit会话使用IFeatureWorkspaceEdit.StartEditing/StopEditing包裹你的更新逻辑。对 Shapefile 来说通常不需要编辑会话但直接用IFeatureCursor.UpdateFeature比Store更稳定。6. 进阶用 Recycle 游标和批量编辑把数据处理速度提上来很多开发者在数据量上去之后会发现属性进表、批量计算字段和空间查询越来越慢甚至卡到像死机。这往往是因为每次循环里都让游标新建对象或者每次编辑都触发了一次完整的事务。升级到 Recycle 游标和批量编辑模式通常能带来一倍以上的性能提升。Recycle 游标的使用很简单就是在调用Search或Update时把recycling参数设为true。这个参数告诉游标每次返回时复用同一个内部对象只把属性值替换成新数据。如果你只是遍历一遍做统计、或者做条件判断不会把要素对象保留到循环之外那么就放心开启 Recycle。批量编辑的另一个关键点是使用IFeatureCursor.UpdateFeature替代每次feature.Store()。public void BatchSetValue(IFeatureClass fc, string field, double newValue) { IQueryFilter qf new QueryFilterClass(); qf.WhereClause 11; IFeatureCursor cursor fc.Update(qf, true); IFeature feature; int index fc.Fields.FindField(field); try { while ((feature cursor.NextFeature()) ! null) { feature.set_Value(index, newValue); cursor.UpdateFeature(feature); } } finally { System.Runtime.InteropServices.Marshal.ReleaseComObject(cursor); } }fc.Update会开启一个编辑游标它本身带有批量写缓冲比逐条Store快不少。但如果数据源是 SDE外部可能还要包一层IEdit会话不能省。还有一个容易踩的坑是UpdateFeature之后不能立即再次set_Value同一条记录必须等下一次NextFeature这是游标自身的规则违反的话容易产生未预期行为。我在做这类数据清洗工具时会把整个处理分成两步第一步先读取一条记录通过计算逻辑得到新字段值把结果放在内存字典里第二步再启动更新游标按主键从字典取值写入。这样做的好处是避免在大量更新时反复打开和关闭查找游标逻辑也清晰很多。你可以根据自己的业务场景调整成三步或四步核心思想是减少游标的新建次数和编辑会话的开关次数。还有一点是对渲染和符号化的影响。遍历更新时如果地图同时显示着这个图层每次Refresh也会拖慢速度。项目里我一般会先mapControl.ActiveView.PartialRefresh或者干脆在处理数据时把图层Visible设为false等处理完再刷新。这样既不打扰用户也能让批处理过程跑得稳当。ArcGIS Engine 这套技术从本世纪初用到现在核心 API 变化不大但正因为稳定很多传统行业的桌面 GIS 业务还挂在这套体系上。刚上手的人容易把官方文档里的示例代码整段搬过来跑了不顺就开始怀疑环境。我的建议是小步快跑先跑通许可再看地图再做操作每一步都把日志打清楚。我也曾经在一个空间查询上卡了两天最后发现只是传入的几何少了空间参考所以这次把这些细节都写出来希望帮到你。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
