ArcObjects Library Reference (GeoDatabase)  

IFeatureCursor Interface

Provides access to members that hand out enumerated features, field collections and allows for the updating, deleting and inserting of features.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Members

Description
Method DeleteFeature Delete the existing Feature in the database corresponding to the current position of the cursor.
Read-only property Fields The fields Collection for this cursor.
Method FindField The index of the field with the specified name.
Method Flush Flush any outstanding buffered writes to the database.
Method InsertFeature Insert a new Feature into the database using the property values in the input buffer. The ID of the new Feature is returned.
Method NextFeature Advance the position of the cursor by one and return the Feature object at that position.
Method UpdateFeature Update the existing Feature in the database corresponding to the current position of the cursor.

CoClasses that implement IFeatureCursor

CoClasses and Classes Description
FeatureCursor ESRI Feature Cursor object.
RelQueryCursor A cursor that is opened from a RelQueryTable.
TemporalCursor (esriTrackingAnalyst) Controls settings for the temporal cursor.

Remarks

The IFeatureCursor interface provides access to a set of features in a feature class. It operates in the same way as ICursor, although it does not inherit from that interface. This saves you from having to use Query-Interface when dealing with features rather than rows.

Feature cursors can be used as an input to IFeatureCursorBuffer, which lets you spatially buffer the features by a distance.

You can also draw the features from a cursor on the display. For more information, see the IFeatureRenderer::Draw method.

When using cursors within an edit session, they should always be scoped to edit operations. In other words, a cursor should be created after an edit operation has begun and should not be used once that edit operation has been stopped or aborted.

.NET Snippets

Zoom to Selected Globe Features | Get All Features from Point Search in GeoFeatureLayer | Perform Spatial Query | Get First Feature from Point Search in GeoFeatureLayer |

.NET Samples

Calculate area geoprocessing function tool (Code Files: CalculateAreaFunction) | Closest facility solver (Code Files: frmClosestFacilitySolver) | Create camera flyby from path (Code Files: frmCameraPath) | Custom reshape polyline edit task (Code Files: ReshapePolylineEditTask) | Cut polygons without selection edit task (Code Files: CutPolygonsWithoutSelectionEditTask) | Displaying MOLE symbology with the GlobeControl (Code Files: MainForm) | Editing using a custom form (Code Files: EditorForm) | Extending the replication synchronization process (Code Files: RasterSyncWorkspaceExtension) | Import signposts (Code Files: ImportDynamapSignsFunction ImportMultiNetSignsFunction ImportNavStreetsSignsFunction SignpostUtilities) | Location-allocation solver (Code Files: frmLocationAllocationSolver) | Multivariate renderer (Code Files: MultivariateRenderer) | Play back tracking data (Code Files: PlaybackDataButton) | RSS weather GraphicTracker (Code Files: RSSWeather) | RSS weather layer (Code Files: AddWeatherItemTool RSSWeatherLayerClass) | Server spatial query COM utility (Code Files: VegUtils_VBNet) | Server spatial query server object extension (Code Files: Extension) | StreetMap routing (Code Files: RoutingForm) | Using the traversal result to select source features (Code Files: SelectFeaturesTool) | ViperPin tool (Code Files: ViperPinForm) |

.NET Related Topics

Updating features | 3DAnalyst | Adjusting feature locations with spatial adjustment | Creating features | Executing spatial queries | Geodatabase | Geodatabase API best practices | How to access the features in an in-memory output layer using IFeatureCursor | How to add point IDs to a polyline | How to create a union of several polygons | How to define a renderer for your layer | How to generate directions | How to zoom to selected features in globe | Managing application state | Querying geodatabase tables | Releasing COM references | Server object extensions (SOE) | Updating attributes of existing features | Using ArcObjects as tool input | Utility COM objects | Working with query cursors |