FindFilter Class
FindFilter Class
Contains the filter used when finding points-of-interest and polygons. Specifies the entity type, properties, and property values that the returned results must match.
Public Class FindFilter Inherits System.Object
[C#]
public class FindFilter : System.Object
Public Properties
Name | Description |
---|---|
EntityTypeName | A string representing the name of the entity type (EntityType.Name property) that the results returned from the point-of-interest and polygon find methods must match. |
Expression | A complex logical expression (object) used to filter the find results returned by the point-of-interest and polygon find methods. |
PropertyNames | An array of strings representing the property names (EntityProperty.Name property) of the selected entity type that the results returned from the point-of-interest and polygon find methods must match. |
SortProperties | Array of entity property names (as an array of objects) used for sorting the find results returned from the point-of-interest and polygon find methods . |
WhereClause | A value filter to apply to the results (WhereClause object) returned from the point-of-interest find and polygon methods. The WhereClause defines the entity property/value pairs that the results returned from the point-of-interest find and polygon methods must match. |
Remarks
The FindFilter object is used in the following methods:
For the FindFilter object to be valid, the EntityTypeName property must contain a value. If the PropertyNames property is null, all properties are returned.
If the WhereClause and Expression properties are both null, all entities are returned (for the FindByID, FindNearby, FindNearRoute, and FindPolygon methods), regardless of their property values; an exception is thrown for the FindByProperty method.
To retrieve the entity types for a specific data source, use the CommonServiceSoap.GetEntityTypes method.
The WhereClause property and the Expression property are mutually exclusive; when both properties are assigned values, an exception is thrown.
You can also use this class to filter entities using the standard properties such as MatchedMethod and MatchCode .
See Also
FindServiceSoap Class | EntityType.Name Property | EntityProperty.Name Property | FilterExpression Class | SortProperty Class | WhereClause Class | FindNearbySpecification.Filter Property | FindByProperty.Filter Property | FindByIDSpecification.Filter Property | FindNearRouteSpecification.Filter Property