Click or drag to resize

Feature Class

Represents a real-world object on a map.
Inheritance Hierarchy

Namespace:  Esri.ArcGISRuntime.Data
Assembly:  Esri.ArcGISRuntime (in Esri.ArcGISRuntime.dll) Version: 100.11.0
public class Feature : GeoElement, INotifyPropertyChanged

The Feature type exposes the following members.

Public propertyCode exampleAttributes
Gets the attributes of this GeoElement as a collection of name/value pairs.
(Inherited from GeoElement.)
Public propertyCode exampleFeatureTable
Gets the FeatureTable that this feature belongs to
Public propertyGeometry
Gets or sets the Geometry of the feature.
(Overrides GeoElementGeometry.)
Public methodGetAttributeValue(String)
Looks up attribute by name and returns its current value.
Public methodGetAttributeValue(Field)
Looks up attribute by Field and returns its current value.
Public methodCode exampleRefresh
Resets the attributes and geometry to the values in the data source
Public methodSetAttributeValue(String, Object)
Looks up attribute by name and updates attribute to the specified value.
Public methodSetAttributeValue(Field, Object)
Looks up attribute by Field and updates attribute to the specified value.
A feature is persisted in a FeatureTable in a data store (such as a database or service) or in a map. Features in the same data store or feature layer have a common attribute schema.


Example Name: FeatureLayerQuery

Find features in a feature table which match an SQL query.

Code example screen shot.

// Copyright 2016 Esri.
// Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
// You may obtain a copy of the License at:
// Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific
// language governing permissions and limitations under the License.

using Esri.ArcGISRuntime.Data;
using Esri.ArcGISRuntime.Geometry;
using Esri.ArcGISRuntime.Mapping;
using Esri.ArcGISRuntime.Symbology;
using System;
using System.Collections.Generic;
using System.Drawing;
using System.Linq;
using System.Threading.Tasks;
using System.Windows;

namespace ArcGISRuntime.WPF.Samples.FeatureLayerQuery
        name: "Feature layer query",
        category: "Data",
        description: "Find features in a feature table which match an SQL query.",
        instructions: "Input the name of a U.S. state into the text field. When you click the button, a query is performed and the matching features are highlighted or an error is returned.",
        tags: new[] { "query", "search" })]
    public partial class FeatureLayerQuery
        // Create reference to service of US States.
        private string _statesUrl = "";

        // Create globally available feature table for easy referencing.
        private ServiceFeatureTable _featureTable;

        // Create globally available feature layer for easy referencing.
        private FeatureLayer _featureLayer;

        public FeatureLayerQuery()

            // Create the UI, setup the control references and execute initialization.

        private void Initialize()
            // Create new Map with basemap.
            Map myMap = new Map(BasemapStyle.ArcGISTopographic);

            // Create and set initial map location.
            MapPoint initialLocation = new MapPoint(-11000000, 5000000, SpatialReferences.WebMercator);
            myMap.InitialViewpoint = new Viewpoint(initialLocation, 100000000);

            // Create feature table using a URL.
            _featureTable = new ServiceFeatureTable(new Uri(_statesUrl));

            // Create feature layer using this feature table. Make it slightly transparent.
            _featureLayer = new FeatureLayer(_featureTable)
                Opacity = 0.6,
                // Work around service setting.
                MaxScale = 10

            // Create a new renderer for the States Feature Layer.
            SimpleLineSymbol lineSymbol = new SimpleLineSymbol(SimpleLineSymbolStyle.Solid, Color.Black, 1);
            SimpleFillSymbol fillSymbol = new SimpleFillSymbol(SimpleFillSymbolStyle.Solid, Color.Transparent, lineSymbol);

            // Set States feature layer renderer.
            _featureLayer.Renderer = new SimpleRenderer(fillSymbol);

            // Add feature layer to the map.

            // Adjust the selection color.
            MyMapView.SelectionProperties.Color = Color.Cyan;

            // Assign the map to the MapView.
            MyMapView.Map = myMap;

        private async void OnQueryClicked(object sender, RoutedEventArgs e)
            // Remove any previous feature selections that may have been made.

            // Begin query process.
            await QueryStateFeature(QueryEntry.Text);

        private async Task QueryStateFeature(string stateName)
                // Create a query parameters that will be used to Query the feature table.
                QueryParameters queryParams = new QueryParameters();

                // Trim whitespace on the state name to prevent broken queries.
                string formattedStateName = stateName.Trim().ToUpper();

                // Construct and assign the where clause that will be used to query the feature table.
                queryParams.WhereClause = "upper(STATE_NAME) LIKE '%" + formattedStateName + "%'";

                // Query the feature table.
                FeatureQueryResult queryResult = await _featureTable.QueryFeaturesAsync(queryParams);

                // Cast the QueryResult to a List so the results can be interrogated.
                List<Feature> features = queryResult.ToList();

                if (features.Any())
                    // Create an envelope.
                    EnvelopeBuilder envBuilder = new EnvelopeBuilder(SpatialReferences.WebMercator);

                    // Loop over each feature from the query result.
                    foreach (Feature feature in features)
                        // Add the extent of each matching feature to the envelope.

                        // Select each feature.

                    // Zoom to the extent of the selected feature(s).
                    await MyMapView.SetViewpointGeometryAsync(envBuilder.ToGeometry(), 50);
                    MessageBox.Show("Retry your query with a valid state name, like 'California'.", "State not found!");
            catch (Exception ex)
                MessageBox.Show("An error occurred.\n" + ex, "Sample error");
<UserControl x:Class="ArcGISRuntime.WPF.Samples.FeatureLayerQuery.FeatureLayerQuery"
        <esri:MapView x:Name="MyMapView" />
        <Border Style="{StaticResource BorderStyle}">
            <StackPanel Orientation="Vertical">
                <TextBlock Text="Enter a state name and click 'Query' to search."
                           TextWrapping="Wrap" FontWeight="SemiBold" TextAlignment="Center" />
                <TextBox x:Name="QueryEntry"
                         Text="New York"
                         Margin="0,5,0,0" />
                <Button Content="Query"
                        Click="OnQueryClicked" />

See Also
Additional Examples
Hyperlink to ExampleDescription
AddFeaturesAdd features to a feature layer.
AnalyzeViewshedCalculate a viewshed using a geoprocessing service, in this case showing what parts of a landscape are visible from points on mountainous terrain.
ClosestFacilityStaticFind routes from several locations to the respective closest facility.
CreateFeatureCollectionLayerCreate a Feature Collection Layer from a Feature Collection Table, and add it to a map.
DeleteFeaturesDelete features from an online feature service.
EditAndSyncFeaturesSynchronize offline edits with a feature service.
EditBranchVersioningCreate, query and edit a specific server version using service geodatabase.
EditFeatureAttachmentsAdd, delete, and download attachments for features from a service.
EditFeatureLinkedAnnotationEdit feature attributes which are linked to annotation through an expression.
FeatureLayerQueryFind features in a feature table which match an SQL query.
GeodatabaseTransactionsUse transactions to manage how changes are committed to a geodatabase.
ListGeodatabaseVersionsConnect to a service and list versions of the geodatabase.
ListRelatedFeaturesList features related to the selected feature.
MapImageSublayerQueryFind features in a sublayer based on attributes and location.
PerformValveIsolationTraceRun a filtered trace to locate operable features that will isolate an area from the flow of network resources.
SceneLayerSelectionIdentify features in a scene to select.
TraceUtilityNetworkDiscover connected features in a utility network using connected, subnetwork, upstream, and downstream traces.
UpdateAttributesUpdate feature attributes in an online feature service.
UpdateGeometriesUpdate a feature's location in an online feature service.