SystemFilter class

Provides a base class for all system filters in the Business Data Connectivity (BDC) service. This class and its members are reserved for internal use and are not intended to be used in your code..

Inheritance hierarchy

System.Object
  System.MarshalByRefObject
    Microsoft.Office.BusinessData.Runtime.FilterBase
      Microsoft.Office.BusinessData.Runtime.SystemFilter

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

Syntax

'Declaration
<SerializableAttribute> _
Public MustInherit Class SystemFilter _
    Inherits FilterBase
'Usage
Dim instance As SystemFilter
[SerializableAttribute]
public abstract class SystemFilter : FilterBase

Remarks

The BDC contains two types of filters:

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

  • System filters System-provided filters. The BDC populates their values as the very last thing it does before the actual execution. These values are securely set and it is not possible to override them.

Following are the system filters that are provided by the BDC:

  • UserProfile filter   Specified in the FilterDescriptor definition. To use this simple filter, declare a filter of the type UserProfile and add a System.String property with the name UserProfilePropertyName, whose value is the name of a user profile property. The BDC looks up the current user's profile, reads the value of the property with this name, and passes it as an argument to the external method that is invoked.

  • SSOTicket filter   Tells the BDC to pass the single sign-on (SSO) ticket from SSO as part of a parameter to the method call.

  • Username filter   Limits the instances by an SSO username. This filter tells the BDC to pass the username from SSO as part of a parameter to the method call.

  • Password filter   Tells the BDC to pass the password from SSO as part of a parameter to the method call.

  • UserContext filter   Limits the instances by the current user's context. This filter tells BDC to append the current Windows user's domain\username to the method call.

  • LastIdSeen filter   Enables chunking for IDEnumerator objects. For Web services and other non-streaming back-end applications, use the LastIdSeen filter in your IDEnumerator object.

Thread safety

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

See also

Reference

SystemFilter members

Microsoft.Office.BusinessData.Runtime namespace