ArcObjects Library Reference (GeoDatabase)

IFeatureCursor.NextFeature Method

Advance the position of the cursor by one and return the Feature object at that position.

[Visual Basic .NET]
Public Function NextFeature ( _
) As IFeature

[C#]
public IFeature NextFeature (
);

[C++]
HRESULT NextFeature(
  IFeature** Object
);

[C++]
Parameters
Object [out, retval]
  Object is a parameter of type IFeature

Product Availability

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

Remarks

If you fetch features out of a geodatabase using a cursor (recycling or non recycling), the spatial reference of the feature, as returned by NextFeature, is guaranteed to be in the spatial reference that you specified in the query filter .

No guarantee however is made that the geometry of the feature will continue to remain in this spatial reference. In particular, if you use a non recycling cursor, then the feature you fetch will be shared with other consumers and any one of these may change its spatial reference at any time. It is the developers responsibility to test the spatial reference or the geometry you get from the feature (via IFeature::Shape) if you retrieve the geometry at a later time and rely on its spatial reference being a specified spatial reference.

.NET Snippets

Zoom to Selected Globe Features | Get First Feature from Point Search in GeoFeatureLayer |

.NET Samples

Calculate area geoprocessing function tool (Code Files: CalculateAreaFunction) | Create camera flyby from path (Code Files: frmCameraPath) | Custom reshape polyline edit task (Code Files: ReshapePolylineEditTask) | Extending the replication synchronization process (Code Files: RasterSyncWorkspaceExtension) | Multivariate renderer (Code Files: MultivariateRenderer) | RSS weather GraphicTracker (Code Files: RSSWeather) | RSS weather layer (Code Files: RSSWeatherLayerClass) | StreetMap routing (Code Files: RoutingForm) | Using the traversal result to select source features (Code Files: SelectFeaturesTool) | ViperPin tool (Code Files: ViperPinForm) |