由于ArcGIS Engine的32位、部署繁重、不适应新一代Web GIS的发展等缺点，Esri推出了ArcGIS Runtime产品，该产品因其64位、部署轻便、跨平台、更好地适应新一代Web GIS的发展而得到越来越多的关注，也有一部分Engine开发者正陆续迁移到Runtime上来。对于使用ArcGIS Engine进行开发的用户来说，加载和编辑本地数据是最常用也是最基本的功能，那么Runtime中如何加载和编辑本地数据呢？我将分两篇文章进行介绍，今天先介绍ArcGIS Runtime SDK for .Net 100.6如何加载本地数据。
ArcGIS Engine中的本地数据包括shapefile、mdb、FileGDB和SDE（这里只讨论本地矢量数据，不讨论Raster），而Runtime可以加载的本地矢量数据为shapefile、Mobile Geodatabase（.geodatabase）、GeoPackage(.gpkg)，FileGDB和SDE数据在Runtime中也是可以加载的，但需要先生成mpk并且借助于Local Server。这里我们只讨论常用的本地数据源——shapefile、FileGDB以及SDE在Runtime中的加载方法。
tips:Runtime中不支持mdb数据库。
一、加载shapefile
shapefile从Runtime 100.2.1版本开始支持，提供了直接的类ShapefileFeatureTable，Runtime中加载Shapefile可以参考下面代码：
// Open the shapefileShapefileFeatureTable myShapefile = await ShapefileFeatureTable.OpenAsync(filepath);// Create a feature layer to display the shapefileFeatureLayer newFeatureLayer = new FeatureLayer(myShapefile);// Add the feature layer to the mapMyMapView.Map.OperationalLayers.Add(newFeatureLayer);// Zoom the map to the extent of the shapefileawait MyMapView.SetViewpointGeometryAsync(newFeatureLayer.FullExtent, 50);
有了FeatureLayer就可以直接对其编辑了。
二、加载FileGDB和SDE
1，生成mpk
ArcGIS Runtime中无法像Engine一样直接加载FileGDB以及SDE数据，需要先生成mpk，如果后续要直接编辑该FileGDB以及SDE的话，那么生成的mpk中需要引用原始数据，否则会将数据复制到该mpk的FileGDB中的，编辑不会反映到原始FileGDB或SDE中。下面简单看下如何通过ArcMap制作mpk，有两种方式：一种是ArcMap的File菜单Share As中生成；另一种是通过GP工具Package Map生成，下面以File菜单中生成为例介绍。
打开ArcMap->File菜单->Share As->Map Package 则弹出下面对话框。可以将mpk上传到Online上，也可以保存在本地，这里我们保存在本地，注意勾选“Support ArcGIS Runtime”，另外，如果要直接编辑FileGDB，需要勾选“Reference all data”。Item Description里的必填项填写完毕就可以Share了，Share之前最好Analyze一下检查有无错误，有错误则按照错误提示进行修改。
tips：使用该工具之前需要先在ArcMap->Customize菜单->ArcMap Options->Sharing 页面中勾选“Enable ArcGIS Runtime Tools”，如下图：
2，Runtime中加载mpk
生成mpk之后就是加载mpk了，Runtime中加载mpk可以通过两种方式：一种通过动态地图服务图层，一种是通过要素服务图层，下面分别看一下。
（1），Local Server可以将本地mpk发布成LocalMapService，然后通过ArcGISMapImageLayer加载，注意ArcGISMapImageLayer是无法进行编辑的，官方链接。
参考代码：
if(_localServer.Status == LocalServerStatus.Started){// Create a local map service from a map package on disk.LocalMapService mapService = new LocalMapService(@"C:\Users\admin\Desktop\subway.mpk");// Start the local service.await mapService.StartAsync();// If the service was not started successfully, report status and return.if (mapService.Status != LocalServerStatus.Started){MessageBox.Show("Local Server could not be started.", "Error");return;}// If the service is started, get the service URL.Uri mapServiceUrl = mapService.Url;// Create a new ArcGISMapImageLayer.ArcGISMapImageLayer localServiceLayer = new ArcGISMapImageLayer(mapServiceUrl){// Set layer opacity to semi-transparent.Opacity = 0.5};await localServiceLayer.LoadAsync();// Add the layer to the map.MyMapView.Map.OperationalLayers.Add(localServiceLayer);//zoom to layer extentawait MyMapView.SetViewpointGeometryAsync(localServiceLayer.FullExtent,5);}
tips：执行MyMapView.SetViewpointGeometryAsync(localServiceLayer.FullExtent,5);时有可能会遇到下面错误：
根据该错误信息可以判断是因为FullExtent为null，这时就会联想到Runtime的Loadable模式，需要在获取该图层的Extent之前，确保该图层已经成功加载，在前面添加await localServiceLayer.LoadAsync();代码即可。
加断点进行调试，发现Local Server会将该mpk发布成本地地图服务：
将该url输入浏览器，结果如下图：
tips:该服务为临时服务，程序关闭即消失。
Runtime中执行结果如图：
（2），Local Server可以将本地mpk发布成LocalFeatureService，然后通过FeatureLayer加载，这种是可以直接编辑的。
参考代码：
if (_localServer.Status == LocalServerStatus.Started){// Create a local feature service from a map package on diskLocalFeatureService featureService = new LocalFeatureService(@"C:\Users\admin\Desktop\subway.mpk");// Start the local service.await featureService.StartAsync();// If the service was not started successfully, report status and return.if (featureService.Status != LocalServerStatus.Started){MessageBox.Show("Local Server could not be started.", "Error");return;}// If the service is started, get the service URL.string featureServiceUrl = featureService.Url.AbsoluteUri;// Create a new service feature table from the dataset with index 0.ServiceFeatureTable localServiceTable = new ServiceFeatureTable(new Uri(featureServiceUrl + "/0"));// Create a new feature layer to display the features in the table.FeatureLayer featureLyr = new FeatureLayer(localServiceTable);await featureLyr.LoadAsync();// Add the layer to the map.MyMapView.Map.OperationalLayers.Add(featureLyr);await MyMapView.SetViewpointGeometryAsync(featureLyr.FullExtent, 5);}
加断点进行调试，会发现Local Server会将该mpk发布成本地要素服务：
将该url输入浏览器，结果如下图：
加载SDE数据与加载FileGDB的方式一样，只不过是先将SDE中的要素类添加到ArcMap中，然后生成mpk，在Runtime加载时要注意需要安装对应数据库的64位客户端，如果SDE的数据库为oracle，那么需要安装64位oracle客户端。
写到这里，也许会有人说这样多麻烦啊，每加载一个数据就需要制作一个mpk！！！别急，Runtime提供了另一种加载FileGDB以及SDE数据源的方式，接着看。
（3）通过DynamicWorkspace的方式加载FileGDB以及SDE
通过DynamicWorkspace替换数据源来显示数据，事先需要生成任意一个mpk，然后利用LocalServer将该mpk发布成本地地图服务，最后替换里面的子图层来显示该动态工作空间中的数据。这种方法比较利于数据的查看，可以同时加载FileGDB以及SDE中的多个图层，但是由于生成的是ArcGISMapImageLayer，所以是无法编辑的。
如果是SDE的话，使用EnterpriseGeodatabaseWorkspace，用连接字符串或者.sde连接文件的绝对路径；如果是FileGDB的话，使用FileGeodatabaseWorkspace，使用该.gdb的绝对路径即可。代码附在下面了，相信您一看就明白了。此外，DynamicWorkspace不仅支持这两种Workspace，还支持ShapefileWorkspace以及RasterWorkspace，如下图：
参考代码：
await StartLocalServer();if(_localServer.Status == LocalServerStatus.Started){LocalMapService myLocalMapService = new LocalMapService(@"C:\Users\admin\Desktop\subway.mpk");// Create an enterprise geodatabase workspace.EnterpriseGeodatabaseWorkspace myEnterpriseGeodatabaseWorkspace = EnterpriseGeodatabaseWorkspace.CreateFromConnectionString("sde", "PASSWORD=***;INSTANCE=sde:oracle11g:192.168.100.104/orcl;USER=sde;VERSION=sde.DEFAULT");FileGeodatabaseWorkspace fileGeodatabaseWorkspace = new FileGeodatabaseWorkspace("fileGDB", @"E:\zxy\E_new\ZhuXinying\testData\Data.gdb");// Create an empty DynamicWorkspace and add a EnterpriseGeodatabaseWorkspace into it's collection.List<DynamicWorkspace> myIEnumerableOfDynamicWorkpace = new List<DynamicWorkspace>();myIEnumerableOfDynamicWorkpace.Add(myEnterpriseGeodatabaseWorkspace);myIEnumerableOfDynamicWorkpace.Add(fileGeodatabaseWorkspace);// Now set the DynamicWorkspace of the LocalMapService to the one just created.myLocalMapService.SetDynamicWorkspaces(myIEnumerableOfDynamicWorkpace);// Start the local map service.await myLocalMapService.StartAsync();// Create an ArcGIS map image layer using the same url as the local map service.Esri.ArcGISRuntime.Mapping.ArcGISMapImageLayer myArcGISMapImageLayer = new Esri.ArcGISRuntime.Mapping.ArcGISMapImageLayer(myLocalMapService.Url);myArcGISMapImageLayer.Name = "EnterpriseLayer";// Create a simple marker symbolSimpleMarkerSymbol mySimpleMarkerSymbol = new SimpleMarkerSymbol();mySimpleMarkerSymbol.Color = Color.Red;mySimpleMarkerSymbol.Size = 10;mySimpleMarkerSymbol.Style = SimpleMarkerSymbolStyle.Circle;// Create a simple rendererSimpleRenderer myMarkerRenderer = new SimpleRenderer();myMarkerRenderer.Symbol = mySimpleMarkerSymbol;SimpleFillSymbol mySimpleFillSymbol = new SimpleFillSymbol();mySimpleFillSymbol.Color = Color.Green;mySimpleFillSymbol.Style = SimpleFillSymbolStyle.Cross;SimpleRenderer myFillRenderer = new SimpleRenderer();myFillRenderer.Symbol = mySimpleFillSymbol;// Create a table sub-layer source using the id from the enterprise geodatabase workspace id and a specific layer in the enterprise geodatabase workspace TableSublayerSource myTableSubLayerSource = new TableSublayerSource("sde", "sde.subway");//Fullyqualified table nameTableSublayerSource myTableSubLayerSource2 = new TableSublayerSource("fileGDB", "省界");// Create a new ArcGIS map image sub-layer based on the table sub-layer source ArcGISMapImageSublayer myArcGISMapImageSublayer = new ArcGISMapImageSublayer(1, myTableSubLayerSource);ArcGISMapImageSublayer myArcGISMapImageSublayer2 = new ArcGISMapImageSublayer(2, myTableSubLayerSource2);myArcGISMapImageSublayer.Renderer = myMarkerRenderer;myArcGISMapImageSublayer2.Renderer = myFillRenderer;// Add the ArcGIS map image sub-layer to the sub-layers collection of the ArcGIS map image layermyArcGISMapImageLayer.Sublayers.Add(myArcGISMapImageSublayer);myArcGISMapImageLayer.Sublayers.Add(myArcGISMapImageSublayer2);await myArcGISMapImageLayer.LoadAsync();// Add the dynamic ArcGIS map image layer to the map.MyMapView.Map.OperationalLayers.Add(myArcGISMapImageLayer);//await MyMapView.SetViewpointGeometryAsync(myArcGISMapImageSublayer2.FullExtent, 5);}
Runtime中执行结果如图：
此外，目前ArcGIS Runtime 100.6也是支持Pro创建的mpkx的，生成mpkx参数如下图：
但是目前Pro 2.4中生成的mpkx中缺少msd文件，导致runtime中报错：
该问题已经确认为Pro的bug，编号为BUG-00013：The Package Map tool in ArcGIS Pro fails to package a .msd file despite enabling Support ArcGIS Runtime and Reference all Data for Runtime in the parameters.
相信后续ArcGIS Pro版本会解决此问题，以便Runtime成功加载mpk和mpkx。就写到这里吧，如果您对Runtime中编辑本地数据感兴趣，敬请期待下一篇…
