IARMap.QueryARFeatures Method

Searches the map using a search definition and returns an ARFeatureSet.

[Visual Basic .NET]
Public Function QueryARFeatures ( _
    ByVal pSearchDef As ArcReaderSearchDef _
) As ARFeatureSet

[C#]
public ARFeatureSet QueryARFeatures (
    ArcReaderSearchDef pSearchDef
);

Product Availability

Description

Queries the ARMap based upon an attribute or spatial query as defined by the ArcReaderSearchDef. Only ARLayer objects with a Searchable property set to true within the ARMap will be searched.

All ARFeature objects matching the query are instantiated in the ARFeatureSet. If the number of features could be very large, this may not be desirable as it may result in a long delay and consume a large amount of memory. Instead use the SearchARFeatures method. If there are no features matching the query the IARFeatureSet::ARFeatureCount property will return 0.

Errors Returned

2029 800A07ED: Unitialized search definition

2034 800A07F2: The query has failed 

2113 800A0841: The current document does not have permission to query features 

Remarks

The QueryARFeatures method will return an error if the currently loaded document was not published with permission to QueryFeatures. Use the IARControl::HasDocumentPermission method to determine this.

If there is an error with the query, such as ill-formed SQL, the error returned will contain an error description from the underlying database.

See Also