UserInputFilter class

Provides a base class for all user input filters in the Business Data Connectivity (BDC) service.

Namespace:  Microsoft.Office.BusinessData.Runtime
Assembly:  Microsoft.Office.BusinessData (in Microsoft.Office.BusinessData.dll)

public abstract class UserInputFilter : FilterBase, 
	IUserInputFilter, IFilter

There are two kinds of filters in the BDC:

  • User Input filters Require users to provide filter values such as the Comparison, Limit and the Wildcard filters.

  • System filters System-provided filters such as UserContext or UserCulture.

For more information about the types of filters, see Types of Filters Supported by BDC.

Following are the User Input filters that BDC supports:

  • Comparison filter   Takes an operator and a condition and returns only the instances that meet the condition. Note that this is the likely behavior as it is up to the external system to implement this filter.

  • Limit filter   Potentially limits the number of instances returned to n. Note that the LimitFilter is a hint for the external system. As such, the external system can ignore this value but it is recommended that it enforces it. Thus, the LimitFilter does not necessarily prevent long wait times but rather reduces the possibility of long wait times.

  • Page number filter Enables pagination to be provided by the external system.

  • Wildcard filter   Limits the instances returned to those where a field such as a field named value, where value may contain the asterisk (*) wildcard character. Users can use this filter type to present more user-friendly filters such as "starts with" and "contains".

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions