ReadFilteredIdentities is used to retrieve a set of identities based on an expression. The expression is a syntax that resembles a SQL WHERE clause. For details about the expressions capabilities, see the documentation of the QueryExpression class.
There are two parts to the expression. There are a set of values that can be used from the identity and they must be AND'ed together. These are things such as the identities DisplayName or IdentityType. All string comparisons are performed case insensitive.
Specific Properties available from all identities: Microsoft.TeamFoundation.Identity Supports: In (FUTURE) -- A direct member of the value which must be a TFID. Under (FUTURE) -- A direct or indirect member of the value which must be a TFID. Near -- Specilized term that has extensible conditions that define near Value must be a TFID.
Microsoft.TeamFoundation.Identity.DisplayName Supports: = -- The display name of the identity is equal to the value. Contains -- The display name of the identity contains to the value. StartsWith -- The display name of the identity is starts with the value Microsoft.TeamFoundation.Identity.Type. Supports: = -- Value must be 'Group' or 'User' Microsoft.TeamFoundation.Identity.Scope. Supports: = -- Value must a string representing the scope Valid scopes are [SERVER], [projecturi], [projectname], and projecturi. If this condition is not supplied, [SERVER] is used.
All other properties will compared with extensible properties associated with the identity. These comparisons MUST follow any well-known properties otherwise these comaprisons will be made against extensible properties.
No parentheses are supported.
Assembly: Microsoft.TeamFoundation.Framework.Server (in Microsoft.TeamFoundation.Framework.Server.dll)
'Declaration Public Function ReadFilteredIdentities ( _ requestContext As TeamFoundationRequestContext, _ expression As String, _ suggestedPageSize As Integer, _ lastSearchResult As String, _ lookForward As Boolean, _ membershipQuery As MembershipQuery _ ) As FilteredIdentitiesList
public FilteredIdentitiesList ReadFilteredIdentities( TeamFoundationRequestContext requestContext, string expression, int suggestedPageSize, string lastSearchResult, bool lookForward, MembershipQuery membershipQuery )
public: virtual FilteredIdentitiesList^ ReadFilteredIdentities( TeamFoundationRequestContext^ requestContext, String^ expression, int suggestedPageSize, String^ lastSearchResult, bool lookForward, MembershipQuery membershipQuery ) sealed
abstract ReadFilteredIdentities : requestContext:TeamFoundationRequestContext * expression:string * suggestedPageSize:int * lastSearchResult:string * lookForward:bool * membershipQuery:MembershipQuery -> FilteredIdentitiesList override ReadFilteredIdentities : requestContext:TeamFoundationRequestContext * expression:string * suggestedPageSize:int * lastSearchResult:string * lookForward:bool * membershipQuery:MembershipQuery -> FilteredIdentitiesList
public final function ReadFilteredIdentities( requestContext : TeamFoundationRequestContext, expression : String, suggestedPageSize : int, lastSearchResult : String, lookForward : boolean, membershipQuery : MembershipQuery ) : FilteredIdentitiesList
Context of the current request execution.
Query Expression that will be used to filter the set of returned identities.
Number of identities the server should return if paging is required.
When paging this was the first or last record from the previous page depending on direction.
When a previous search result was supplied which direction does the search continue.
What type of membership should be returned for the resulting identities.
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.