ArcObjects SDK 010 FeatureLayer
FeatureLayer是我们开发的时候用的最多的API之一，其实现的接口以及关联的其他API也非常多。下面我们就用一张图来整体看下FeatureLayer有哪些常用的功能。
FeatureLayer类继承实现了非常多的接口。每个接口主要负责什么功能呢？我们可以参考每个接口定义属性和函数，还有一个更直观的方法，就是最找ArcMap软件。
IFeatureLayer接口的FeatureClass属性主要对应着矢量图层属性对话框中的Source选项卡 。IGeoFeatureLayer的Renderer属性对应Symbology选项卡，AnnotationProperties属性对应着Labels选项卡。IFeatureSelection接口对应Selection选项卡。ILayerFields接口对应着Fields选项卡。ILayerGeneralProperties接口对应General选项卡。IFeatureLayerDefinition接口对应Definition Query选项卡。IHTMLPopupInfo以及相似名字的几个接口对应着HTML Popup选项卡。IRelationshipClassCollection接口对应Joins&Relates选项卡。矢量图层属性对话框如下图所示。
IFeatureLayer的FeatureClass属性返回的是IFeatureClass类型，这就是我们的矢量图层实际指向的数据源。我们用代码打开一个Shape文件，获得的就是一个IFeatureClass对象。FeatureLayer的FeatureClass属性对应的属性标签如下图所示。
如果我们打开的是一个Shape文件，通过上图以及参考SDK的API，能够直观的看出可以获得数据的空间范围、数据类型、文件路径、几何体类型、空间参考等信息。
FeatureClass，我们可以理解为有一个几何体字段的二维数据表。二维数据表字段、有数据行，FeatureClass中的字段定义是IField，数据行定位为IFeature。因为包含一个几何体字段，所有就区分几何体类型，是Point、Polyline或者Polygon。所示IField的类型就多了一个几何体类型，定义为esriFieldType. esriFieldTypeGeometry。IFeature也有一个属性，名为Shape，返回该数据行存储的几何体。
通过IGeoFeatureLayer的Renderer属性可以获得地图的渲染对象IFeatureRenderer，IFeatureRender对应了矢量图层选项卡中的Symbology，如下图所示。
该选项卡中做的为矢量图层可使用的渲染类型，有的为选中的渲染类型的属性信息。矢量图层支持哪些渲染方式，可展开左侧树结构查看，也可以在ArcObject SDK的帮助中查看有哪些类继承实现了IFeatureRenderer接口，两者是可以对应起来的。
以最简单的SimpleRenderer为例，其对应的是渲染界面上的Single symbol项，这点在帮助里面也有说明。
其主接口为ISimpleRenderer，其定义基本上也和ArcMap上的UI是对应起来的，如下图所示。
通过IGeoFeatureLayer接口的AnnotationProperties属性可以获取IAnnotateLayerPropertiesCollection接口，该接口是IAnnotateLayerProperties的集合，包含多个IAnnotateLayerProperties接口实例。这点我们也可以在ArcMap的Label标签页中验证，矢量图层在Label的时候，可以设置多种Label规则。如下图所示。
实现IAnnotateLayerProperties接口的类有两个，我们常用的是 LabelEngineLayerProperties，而LabelEngineLayerProperties又继承了ILabelEngineLayerProperties、ILabelEngineLayerProperties2等接口。这些接口定义的信息，基本上就能把Label选项卡中的内容对应上了。
FeatureLayer实现继承了IFeatureSelection接口，该接口定义的内容可以Selection选项卡里找到。
IFeatureSelection的SelectFeatures可以通过设置查询条件来选择或者反选要素。查询条件既可以设置为属性查询条件，也可以设置为空间查询条件。
esriSelectionResultEnum枚举的定义如下。
IFeatureLayer和IFeatureClass都有Search函数，两者有什么区别呢？我们先看IFeatureLayer的Search函数。我们打开IFeatureLayer. Search函数的帮助，如下图所示。
如果该图层定义了查询集，有就是说在IFeatureLayerDefinition接口的DefinitionExpression属性（ArcMap的Definition Query标签页）定义了查询条件，那么IFeatureLayer的Search函数就会在该查询的基础上进行查询。如果该图层使用Join连接了某个图层或者属性表，但查询的字段有该连接对象的字段，那么请调用IGeoFeatureLayer.SearchDisplayFeatures函数。
IFeatureLayer.Search函数返回的游标，也就是IFeatureCursor接口，不能用来更新要素，如果想更新要素，请使用IFeatureClass.Update函数。
回收游标第二个参数设置为true，否则设置为false。一般我们调用IFeatureLayer.Search函数后，返回的是IFeatureCursor，我们称为要素游标，通过该游标可以遍历查找结果。一般遍历方法如下所示。
IFeatureCursor myFeatureCursor = myFeatureLayer.Search(myQueryFilter, false); IFeature myFeature = myFeatureCursor.NextFeature(); while (myFeature != null) { myFeature = myFeatureCursor.NextFeature(); } ComReleaser.ReleaseCOMObject(myFeatureCursor);
如果传false，FeatureCursor.NextFeature之后，上一个IFeature还可以使用，如果是true，则就不能用了。传true会更节约内存，但你要把你想取的信息全部都取出来。
IFeatureClass的Search函数与IFeatureLayer的Search函数类似，只是其在原始数据的基础上查询，和图层的设置没有关系。
该函数用来批量添加要素。如果我们添加一个要素，可以调用IFeatureClass. CreateFeature函数，得到一个IFeature实例，然后对其赋值，最后调用IFeature的Store函数即可。但如果我们要批量添加多个要素，就要调用IFeatureClass.Insert函数，得到要素添加游标，在该游标上添加要素，最后一起提交即可。调用Insert函数的代码基本上都是一样的，使用的时候参考下面的模板即可。
IFeatureBuffer myFeatureBuffer = myFeatureClass.CreateFeatureBuffer(); IFeatureCursor myFeatureCursor = myFeatureClass.Insert(true); for (int i = 0; i < myXList.Count; i++) { var myPoint = new PointClass { X = myXList[i], Y = myYList[i] }; myFeatureBuffer.Shape = myPoint; myFeatureBuffer.Value[2] = i; myFeatureBuffer.Value[3] = 0; myFeatureCursor.InsertFeature(myFeatureBuffer); if (i % 1000 == 0) { myFeatureCursor.Flush(); } } if (this.InputDataTable.Rows.Count % 1000 > 0) { myFeatureCursor.Flush(); } ComReleaser.ReleaseCOMObject(myFeatureCursor);
FeatureCursor.Flush()是提交函数，如果添加的要素太多，最后一次性提交，会导致运行太慢哪，把进度条卡住，所以我一般会每1000条提交依次，这个数可以根据实际情况修改。
该函数用看来批量更新要素。和Insert函数类似，如果我们只是操作一个要素，可以在获取IFeature之后，修改其属性值，调用最后调用IFeature的Store函数即可。但如果要批量更新，则建议采用IFeatureClass.Update函数，效率会比较高。调用Update函数的代码基本上都是一样的，使用的时候参考下面的模板即可。
int myLevelFieldIndex = myFeatureClass.FindField("Level"); int myValueFieldIndex = myFeatureClass.FindField("Value"); IFeatureCursor myFeatureCursor = myFeatureClass.Update(null, true); IFeature myFeature = myFeatureCursor.NextFeature(); while (myFeature != null) { double myValue = Convert.ToDouble(myFeature.Value[myValueFieldIndex]); myFeature.Value[myLevelFieldIndex] = this.GetLevel(myValue); myFeatureCursor.UpdateFeature(myFeature); myFeature = myFeatureCursor.NextFeature(); } ComReleaser.ReleaseCOMObject(myFeatureCursor);
该函数用来批量删除要素。如果要删除单个要素，可以调用得到的IFeature.Delete函数。如果批量删除或者根据某个条件来删除要素，则可以调用ITable.DeleteSearchedRows函数。FeatureClass是继承实现了ITable接口的，所以我们把IFeature接口转换成ITable接口，调用该函数即可。一般调用代码如下。
ITable myTabel = this.PointFeatureLayer.FeatureClass as ITable; IQueryFilter myQueryFilter = new QueryFilterClass { WhereClause = "RowIndex=" + pRowIndex.ToString() }; myTabel.DeleteSearchedRows(myQueryFilter);
ITable.DeleteSearchedRows函数的参数为IQueryFilter，除了QueryFilter类外，SpatialFilter类也继承了该接口。但DeleteSearchedRows函数又是在ITable接口中定义的，那这个函数是不是支持SpatialFilter，可以去验证下，但我感觉应该是支持的。
获取字段有两种方式，一是通过FeatureLayer继承实现了ILayerFields接口获取字段，另外一种是通过矢量数据源IFeatureClass的Fields属性获取IFields接口获取字段信息。
可以通过索引或字段名称获取具体的字段信息，返回是IField接口。我们再看下ILayerFields接口的定义。
我们看到除了返回IField外，还可以返回IFieldInfo，这两个有什么区别呢？IField是数据源中字段的定义，IFieldInfo是图层对字段定义的扩展。我们看下IFieldInfo的定义，如下图所示。
在IField的基础上扩展了字段别名，按照字符串返回某个要素该字段的值，属性表显示的时候该字段是否高亮显示，数字显示格式、是否只读、字段是否按照比率显示，是否可见。我们常用的主要有别名、是否可见等属性。这些信息对应了ArcMap矢量属性对话框中的Fields选显卡，如下图所示。
右侧字段详细信息分为两组，上面可设置的部分为IFieldInfo的信息，下面只读的信息为IField信息。
对字段相关的操作主要是添加和删除。在Arcobjects中很少更新字段，基本上都是添加新字段，把旧字段的值设置到新字段中，删除旧字段。
添加字段可以实例化一个IField对象，然后通过IFeatureClass的AddField函数添加字段。添加的时候需要注意，数据源不要被其他应用占用，否则会发生锁定错误。
var myFeatureClass = ShapeFileHelper.OpenShapeFile(pContourPolygonFile); IField myField = new Field(); IFieldEdit myFieldEdit = myField as IFieldEdit; myFieldEdit.Name_2 = "Level"; myFieldEdit.Type_2 = esriFieldType.esriFieldTypeInteger; myFeatureClass.AddField(myField);
删除字段可调用IFeatureClass的DeleteField函数，调用的时候，还是需要注意，数据源不要被其他应用占用，否则会发生锁定错误。
打开Shape文件后，我们就可以获得IFeatureClas。打开Shape文件的代码比较固定，使用下面的代码打开即可。
var myType = Type.GetTypeFromProgID("esriDataSourcesFile.ShapefileWorkspaceFactory"); var myObject = Activator.CreateInstance(myType); var myWorkspaceFactory = myObject as IWorkspaceFactory; var myFeatureWorkspace = myWorkspaceFactory.OpenFromFile(System.IO.Path.GetDirectoryName(pShapeFilePath), 0) as IFeatureWorkspace; return myFeatureWorkspace.OpenFeatureClass(System.IO.Path.GetFileNameWithoutExtension(pShapeFilePath));
创建Shape文件代码模式也很固定，即使是往gbd或者企业sde数据库中创建矢量数据的时候，我一般也喜欢先在一个临时目录下创建shape文件，然后调用Arctoolbox里面的工具，把这个数据拷贝到目标工作空间中。主要还是因为直接创建shape文件更简单，更稳定，而且不用考虑针对那么多数据源再分别写代码。
string myFolderPath = System.IO.Path.GetDirectoryName(pShapeFilePath); if (System.IO.Directory.Exists(myFolderPath) == false) { System.IO.Directory.CreateDirectory(myFolderPath); } string myFileName = System.IO.Path.GetFileName(pShapeFilePath); var myType = Type.GetTypeFromProgID("esriDataSourcesFile.ShapefileWorkspaceFactory"); object myObject = Activator.CreateInstance(myType); var myWorkspaceFactory = myObject as IWorkspaceFactory; var myFeatureWorkspace = myWorkspaceFactory.OpenFromFile(myFolderPath, 0) as IFeatureWorkspace; //定义字段信息 var myFields = new FieldsClass(); var myFieldsEdit = myFields as IFieldsEdit; foreach (IField myField in pFieldList) { myFieldsEdit.AddField(myField); } //创建shapefile IFeatureClass myFeatureClass = null; try { myFeatureClass = myFeatureWorkspace.CreateFeatureClass(myFileName, myFields, null, null, esriFeatureType.esriFTSimple, "shape", ""); } finally { ComReleaser.ReleaseCOMObject(myWorkspaceFactory); } return myFeatureClass;
创建完之后，得到IFeatureClass，如果不需要，就可以把该对象释放掉。如果需要添加要素，则可以通过调用其Insert函数，批量添加要素。如果想添加到地图上，则实例化一个FeatureLayer，把该对象赋值给FeatureLayer的FeatureClass对象，然后设置渲染样式，即可添加到地图上展示。
