mapgis-desktop-dnet

name	mapgis-desktop-dnet
description	Use when building, debugging, or explaining MapGIS Desktop .NET secondary development, including MapGIS plugin commands, PluginEngine, WorkSpaceEngine, GISControl MapControl, GeoObjects, GeoDataBase, GeoMap, spatial analysis, raster analysis, 3D scene control, and MapGIS desktop API lookup.

MapGIS Desktop .NET

Source Notice

本 Skill 根据公开的 MapGIS Desktop API 文档整理生成，用于辅助 MapGIS 桌面端 .NET 二次开发中的资料检索、接口定位和开发说明。MapGIS、MapGIS Desktop API 及相关接口、示例、文档内容的权利归其权利人所有；若本 Skill 中的整理内容与 MapGIS 官方发布内容不一致，以 MapGIS 官方文档为准。相关 API 与官方文档的最终解释权归 MapGIS 方所有。

Core Rule

回答或实现 MapGIS 桌面端 .NET 二次开发任务时，先查本技能的离线资料，再给出 API 名称、命名空间、程序集和用法。不要凭记忆猜类名、方法签名、枚举值或插件接口。

Workflow

1. 判断用户场景，先读对应指南：
   • 插件、命令、Ribbon、应用宿主：references/guides/plugin-development.md
   • 二维地图视图、闪烁、高亮、地图交互：references/guides/map-control.md
   • 数据源、GDB、要素类、记录集、图层数据：references/guides/data-and-geodatabase.md
   • 几何、拓扑、空间分析、栅格分析、三维分析：references/guides/geometry-and-analysis.md
   • UI 控件、属性页、常见错误排查：references/guides/ui-and-troubleshooting.md
2. 用本地索引定位准确 API：
   • python3 scripts/search_api.py ICommand --kind interface
   • python3 scripts/search_api.py MapControl --kind class
   • python3 scripts/search_api.py GeometryType --kind enum
   • python3 scripts/search_api.py RecordSet --namespace MapGIS.GeoDataBase
3. 需要完整签名、参数或示例时，打开检索结果中的 reference_path。这些文件按命名空间组织在 references/api/ 下。
4. 输出方案时给出最少必要的可追溯信息：类型名、命名空间、程序集、关键成员、引用文件路径。

Reference Map

• references/api-index.json 是机器可读总索引，覆盖程序集、命名空间、类型、源 URL、引用路径、摘要和成员关键词。
• references/api-summary.md 是离线 API 库概览。
• references/api/<assembly>/<namespace>.md 是完整离线 API 正文。
• scripts/build_reference.py 用于从官网重新生成引用库。
• scripts/search_api.py 用于开发时快速查找 API。
• scripts/validate_skill.py 用于验证技能结构和关键 API 可检索性。

Development Defaults

• 默认使用 C# / .NET 桌面插件语境描述代码。
• 优先使用官方 API 中存在的类型和成员，不自行发明封装层。
• 插件开发先确认 MapGIS.PluginEngine 接口，再考虑 UI 或业务代码。
• 地图显示与交互优先查 MapGIS.GISControl.MapControl、MapGIS.GeoMap、MapGIS.GeoObjects。
• 数据读写优先查 MapGIS.GeoDataBase 和具体数据集/要素类/记录集类型。
• 三维场景优先查 MapGIS.Scene3D，不要把二维 MapControl 用法直接套到三维控件。