Creates a new QueryTask object used to execute a query on the layer resource identified by the URL.

The geometry to apply to the spatial filter. The spatial relationship as specified by spatialRelationship is applied to this geometry while performing the query. The valid geometry types are Extent, Point, Multipoint, Polyline, or Polygon.

Code snippets:

      function executeQueryTask(event) {
        //When the user clicks on a map, the onClick event returns the event point 
		where the user clicked. The event contains mapPoint (esri.geometry.Point)

        query.geometry = event.mapPoint;

        //Execute task
        queryTask.execute(query, showResults);
      }

Attribute fields to include in the FeatureSet. Fields must exist in the map layer. You must list the actual field names rather than the alias names. Returned fields are also the actual field names. However, you are able to use the alias names when you display the results. You can set field alias names in the map document or in Manager.

When you specify the output fields, you should limit the fields to only those you expect to use in the query or the results. The fewer fields you include, the faster the response will be.

Each query must have access to the Shape and Objectid fields for a layer, but your list of fields does not need to include these two fields.

Code snippets:

query.outFields = ["NAME", "STATE_ABBR", "POP04"];

The spatial reference for the returned geometry. If not specified, the geometry is returned in the spatial reference of the map. See Projected Coordinate Systems and Geographic Coordinate Systems for the list of supported spatial references.

If "true", each feature in the FeatureSet includes the geometry. Set to "false" (default) if you do not plan to include highlighted features on a map since the geometry makes up a significant portion of the response.

Known values: true | false

Default value: false

The spatial relationship to be applied on the input geometry while performing the query. The valid values are listed in the Constants table.

Default value: SPATIAL_REL_INTERSECTS

Code snippets:

var myQuery = new esri.tasks.Query();
myQuery.spatialRelationship = esri.tasks.Query.SPATIAL_REL_CONTAINS;

Shorthand for a where clause using "like". The field used is the display field defined in the map document. You can determine what the display field is for a layer in Services Directory.

Code snippets:

query.text = stateName;

A where clause for the query. Any legal SQL where clause operating on the fields in the layer is allowed.

Code snippets:
Sring query example. Be sure you have the correct sequence of single and double quotes when writing the where clause in JavaScript.

  query.where = "NAME = '" + stateName + "'"; 
		

Number query example.

  query.where = "POP04 > " + population;