IQueryResultOptions Interface

Provides access to methods that control query results.

Members

Name Description
Read/write property Format The query result format.
Read/write property FormatProperties Format properties specific to result format.
Read/write property GeoTransformation Geo transformation required to transform the geometry if the requested GCS is different from the source.

IQueryResultOptions.Format Property

The query result format.

Public Property Format As esriQueryResultFormat
public esriQueryResultFormat Format {get; set;}

Remarks

The query result can be formatted into a RecordSet or KMZ format (either as a URL to the kmz file or a Mime object).

IQueryResultOptions.FormatProperties Property

Format properties specific to result format.

Public Property FormatProperties As IPropertySet
public IPropertySet FormatProperties {get; set;}

Remarks

FormatProperties is currently not in use.

IQueryResultOptions.GeoTransformation Property

Geo transformation required to transform the geometry if the requested GCS is different from the source.

Public Property GeoTransformation As IGeoTransformation
public IGeoTransformation GeoTransformation {get; set;}

Remarks

In some instances the QueryResult may require a GeoTransformation . For example, a given map service may be using a spatial reference system based on GCS_WGS_1984, found in the DefaultMapDescription. A client wants to display QueryFeatureData2 results based on this map service in a different spatial reference, GCS_European_1950. The results will use the spatial reference of the DefaultMapDescription, GCS_WGS_1984, and display these results, incorrectly in GCS_European_1950. Features may not "line up" correctly. In order to correctly display these results a GeoTransformation is needed. Applying the correct GeoTransformation ensures the spatial correctness of the result.

Another instance where a GeoTransformation may be need to be specified in the QueryResultsOption is if the queried layer is projected on the fly within the map service, that is coordinate system of the layer's source is different than the DefaultMapDescription coordinate system, and no appropriate transformation has been set in the map document before serving. In this case, you can access the the coordinate system of a layer source by first getting the layer's MapLayerInfo, then get Fields from MapLayerInfo, then get a single Field from Fields, then get GeometryDef from Field, and finally, get the SpatialReference from GeometryDef.

A GeoTransformation is not needed if different projected coordinate systems share the same underlying geographic coordinate system. For best results it is optimal for data (layers within the map service), map service and MapServer output to be in the same coordinate system.

Dim pSRFactory As ISpatialReferenceFactory2

pSRFactory = New SpatialReferenceEnvironment

Dim pGeoTrans As IGeoTransformation

pGeoTrans = pSRFactory.CreateGeoTransformation(esriSRGeoTransformation3Type.esriSRGeoTransformation_NAD_1927_To_WGS_1984_30)

pQueryResultOptions.GeoTransformation = pGeoTrans

Classes that implement IQueryResultOptions

Classes Description
QueryResultOptions Query Result Options CoClass.

Remarks

IQueryResultOptions has a property used to select the output Format of a query result. The query result can be formatted into a RecordSet or KMZ format (either as a URL to the kmz file or a Mime object). Another property includes GeoTransformation . This property is used to specify any needed geographic transformation on the results.

FormatProperties is currently not in use.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.