RaveGeoDataSet.SearchableAttributes Property
The attributes that will be used to create a search index for the dataset.
Syntax
public AtomCollection SearchableAttributes { get; }Property Value
This property can only be modified before the dataset has been initialized. Attempting to modify it after initialization will cause an exception to be thrown.
Remarks
This property lists all feature attributes that will be included in a search index associated with the dataset.
You should only include attributes that contain relatively unique texts in a search index. For example, if you have a vector dataset that contains point features that represent cities and each feature has a NAME attribute and a COUNTRYNAME attribute, containing the city name and the name of the country the city is located respectively, then you should only include the NAME attribute in the index.
On the other hand if you have a vector dataset that contains cities where each city has both a NAME and an ASCIINAME attribute, where the latter contains a version of the name using only the ASCII character set, then it can make sense to include both in the search index.
Another case where including more than one attribute in the search index is useful is if you have a vector dataset that contains features that represent different classes of objects that have different sets of attributes associated with each feature. For example, a dataset that contains airports that have an ICAO_CODE attribute and airways that have an AIRWAY_NAME attribute. Adding both attributes to the search index will allow an application to find either one.
The text index will perform Unicode case folding and remove diacritics from all Latin script characters in texts added to the index. This means that search operations will be can return more hits than expected since both case and diacritics on Latin script characters are ignored.
Searching at runtime
Search indexes can be used to find features at runtime in two ways:
You can search in individual datasets through the ISearchable interface, which is implemented by all vector datasets that can have a search index.
You can search all searchable datasets under a layer or operator by calling Layer.GetFeatures or Operator.GetFeatures and passing a search text through the FeatureQuery.SearchText property.
Either method to search for features can be slow and use a lot of memory if the search text is short and matches a lot of features. To prevent this you can specify the maximum number of features that can be returned. The ISearchable.Search methods has overloads that take a count parameter. If you search from a layer or operator you can set the FeatureQuery.SearchCount property.
Platforms
Windows, Linux