This document is archived and information here might be outdated.  Recommended version.

IQueryFilter Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Geodatabase > ESRI.ArcGIS.GeoDatabase > Interfaces > IQ > IQueryFilter Interface
ArcGIS Developer Help

IQueryFilter Interface

Provides access to members that filter data based on attribute values and or relationships.

Product Availability

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


IQueryFilter filters data based on an attribute query. A string defining a where clause is required. An optional list of columns may be included to specify the column values to be retrieved. If no columns are specified, all values will be returned.

When To Use

When you need to filter data based on attribute values or the relationships between attributes.


Name Description
Method AddField Appends a single field name to the list of sub-fields.
Read/write property OutputSpatialReference The spatial reference in which to output geometry for a given field.
Read/write property SubFields The comma delimited list of field names for the filter.
Read/write property WhereClause The where clause for the filter.

Classes that implement IQueryFilter

Classes Description
ImageQueryFilter (esriCarto) An image query filter.
QueryFilter Esri Query Filter object.
SpatialFilter Esri Spatial Filter object.
TemporalQueryFilter (esriTrackingAnalyst) Controls properties for the temporal query filter.
TimeQueryFilter (esriCarto) TimeQueryFilter Class


Unlike the QueryDef object, QueryFilter objects are supported across all workspace types, including shapefiles and coverages.

For datasets that support it, an ORDER BY clause can be set on the attribute query by using the IQueryFilterDefinition::PostfixClause property.

See Also

IQueryDef Interface | ISpatialFilter Interface | esriSpatialRelEnum Constants

.NET Samples

Create a Mosaic dataset Create a custom raster type from the ground up for DMCII data Calculate area geoprocessing function tool Executing geoprocessing tools in the background Multivariate renderer Extending the replication synchronization process Implementing extended criteria for some predefined schematic rules StreetMap routing