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()函數即可。