ESRI.ArcGIS.ADF.IMS
Identify(Point,Double) Method
See Also 
ESRI.ArcGIS.ADF.IMS.Carto.Layer Namespace > FeatureLayer Class > Identify Method : Identify(Point,Double) Method




point
The map-point on which to identify features.
expandPercentage
Percentage-based tolerance to determine the size of the envelope created around the map-point.
Identifies or queries features on a layer based on a screen-point and an expand-percentage tolerance.

Syntax

Visual Basic (Declaration) 
Public Overloads Function Identify( _
   ByVal point As Point, _
   ByVal expandPercentage As Double _
) As FeatureTable
Visual Basic (Usage)Copy Code
Dim instance As FeatureLayer
Dim point As Point
Dim expandPercentage As Double
Dim value As FeatureTable
 
value = instance.Identify(point, expandPercentage)
C# 
public FeatureTable Identify( 
   Point point,
   double expandPercentage
)

Parameters

point
The map-point on which to identify features.
expandPercentage
Percentage-based tolerance to determine the size of the envelope created around the map-point.

Return Value

FeatureTable object containing the identified features.

Remarks

This is a convenient way to identify features near a point on the map. It is similar to using a Query method with a point in the filter of the query parameters.

The point parameter must have coordinates in map (real-world) coordinates. If you have pixel coordinates instead of map coordinates, you can use Identify(int, int, double), which takes pixel coordinates. Alternatively, you can use Point.ToMapPoint to convert the screen coordinates to map coordinates.

The expandPercentage is the percentage of the current map extent. An envelope of the specified size is constructed centered on the input point. The expandPercentage value must be greater than zero, and no greater than 100.

This method returns a FeatureTable. Since a FeatureTable inherits from System.Data.DataTable, it can be used as the data source for data-bound controls that accept a DataTable, such as the GridView control or DetailsView control. This can make it simple to display the results of a query or identify operation.

If no features are found, the method returns a DataTable with no rows. Check the DataTable's Rows.Count property to see whether any features are found.

See Also

© 2010 All Rights Reserved.