ArcGIS Pro SDK 002 对数据文件的读取和操作

做系统开发或者数据处理的时候，我一般还是喜欢使用文件数据源，例如矢量用.shp文件存储，栅格数据用.tif或者.img文件存储。ArcGIS Pro SDK中对数据源操作的API和ArcObjects SDK中差别还是比较大的。

1、打开数据文件

打开文件数据的步骤如下。

（1）使用Shape文件所在的目录，创建FileSystemConnectionPath对象，该对象是文件系统连接路径对象。

（2）使用FileSystemConnectionPath对象创建FileSystemDatastore，该对象是文件系统数据存储器对象。

（3）使用FileSystemDatastore，打开指定数据名称的数据源。打开数据源函数是一个模板函数，如果是Shape文件，则返回FeatureClass，如果是栅格数据，返回RasterDataset，如果是dbf数据，则返回Table。

代码如下。

string myFileName = System.IO.Path.GetFileName(pShapeFile);
var myFileSystemConnectionPath = new FileSystemConnectionPath(new Uri(myFolderPath), FileSystemDatastoreType.Shapefile);

FileSystemDatastore myFileSystemDatastore = null;
FeatureClass myFeatureClass = null;
try
{
    await Task.Run(() =>
    {
        myFileSystemDatastore = new FileSystemDatastore(myFileSystemConnectionPath);
        myFeatureClass = myFileSystemDatastore.OpenDataset<FeatureClass>(myFileName);
    });
    myFileSystemDatastore?.Dispose();
}
catch (Exception ex)
{
    myFileSystemDatastore?.Dispose();
    throw new ArgumentException("打开文件失败。" + pShapeFile + "," + ex.Message);
}
return myFeatureClass;

需要注意的是，ArcGIS Pro SDK中，很多函数都是异步函数，需要添加到await Task.Run(() =>{}里面执行。开发的时候，把鼠标放到函数上，会有提示。如下图所示。

如果要打开栅格数据，代码思路是一样的，只是在初始化FileSystemConnectionPath的时候，传入Raster，知识在OpenDataset的时候，传入RasterDataset即可。代码如下所示。

string myFileName = System.IO.Path.GetFileName(pRasterFile);
var myFileSystemConnectionPath = new FileSystemConnectionPath(new Uri(myFolderPath), FileSystemDatastoreType.Raster);
FileSystemDatastore myFileSystemDatastore = null;
RasterDataset myRasterDataset = null;
try
{
    await Task.Run(() =>
    {
        myFileSystemDatastore = new FileSystemDatastore(myFileSystemConnectionPath);
        myRasterDataset = myFileSystemDatastore.OpenDataset<RasterDataset>(myFileName);
    });
    myFileSystemDatastore?.Dispose();
}
catch (Exception ex)
{
    myFileSystemDatastore?.Dispose();
    throw new ArgumentException("打开文件失败。" + pRasterFile + "," + ex.Message);
}
return myRasterDataset;

打开dbf的时候，FileSystemConnectionPath还是使用FileSystemDatastoreType.Shapefile，在Open的时候，返回Table。代码如下所示。

myTable = myFileSystemDatastore.OpenDataset<Table>(myFileName);

2、读取FeatureClass

得到FeatureClass后，我们可以遍历里面要要素，读取其中的信息。方法和ArcObjects SDK中的流程类似，也是使用了Search方法，返回Cursor变量。具体使用方法如下面代码所示。

await Task.Run(() =>
{
    var myDefinition = myFeatureClass.GetDefinition();
    this._SpatialReference = myDefinition.GetSpatialReference();
    int my_gridcode_FileIndex = myDefinition.FindField("gridcode");
    RowCursor myRowCursor = myFeatureClass.Search(null, true);
    while (myRowCursor.MoveNext())
    {
        Feature myFeature = myRowCursor.Current as Feature;
        DraExtBasin myNewBasin = new DraExtBasin
        {
            FID = myFeature.GetObjectID(),
            SnapPourPointFID = Convert.ToInt64(myFeature.GetOriginalValue(my_gridcode_FileIndex)),
            Polygon = PolygonBuilderEx.CreatePolygon(myFeature.GetShape() as Polygon)
        };
        myFeature.Dispose();
        myBasinList.Add(myNewBasin);
    }
    myRowCursor.Dispose();
});

我们通过FeatureClass.GetDefinition()函数，得到FeatureClass的一些定义信息，通过定义信息，可以获取数据的空间参考、字段等，这点和ArcObjects SDK中差别还是挺大的。

3、添加和编辑Feature

添加Feature和ArcObjects SDK类似，也是使用RowBuffer进行添加，代码如下所示。

await Task.Run(() =>
{
    var myDefinition = myFeatureClass.GetDefinition();
    int my_P_FID_FI = myDefinition.FindField("P_FID");
    int my_D_Length_FI = myDefinition.FindField("D_Length");
    int my_P_Dis_FI = myDefinition.FindField("P_Dis");
    RowBuffer myRowBuffer = myFeatureClass.CreateRowBuffer();
    foreach (DraExtFullBasin myFullBasin in pFullBasinList)
    {
        double myDLength = 0;
        double myPDis = 0;
        if (myMainDrainageD.ContainsKey(myFullBasin.SnapPourPointFID))
        {
            var myDraExtMainDrainage = myMainDrainageD[myFullBasin.SnapPourPointFID];
            myDLength = myDraExtMainDrainage.DrainageLength;
            myPDis = myDraExtMainDrainage.SnapPourPointDistance;
        }
        myRowBuffer[1] = myFullBasin.Polygon;
        myRowBuffer[my_P_FID_FI] = myFullBasin.SnapPourPointFID;
        myRowBuffer[my_D_Length_FI] = myDLength;
        myRowBuffer[my_P_Dis_FI] = myPDis;
        myFeatureClass.CreateRow(myRowBuffer);
    }
    myRowBuffer.Dispose();
});

编辑的话，就是获取Row或者Feature之后，修改信息，最后调用对象的Store()函数即可。