TeamFoundationIdentityService.ReadFilteredIdentities Method
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.
Namespace: Microsoft.TeamFoundation.Framework.Server
Assembly: Microsoft.TeamFoundation.Framework.Server (in Microsoft.TeamFoundation.Framework.Server.dll)
Syntax
'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
Parameters
requestContext
Type: Microsoft.TeamFoundation.Framework.Server.TeamFoundationRequestContextContext of the current request execution.
expression
Type: System.StringQuery Expression that will be used to filter the set of returned identities.
suggestedPageSize
Type: System.Int32Number of identities the server should return if paging is required.
lastSearchResult
Type: System.StringWhen paging this was the first or last record from the previous page depending on direction.
lookForward
Type: System.BooleanWhen a previous search result was supplied which direction does the search continue.
membershipQuery
Type: Microsoft.TeamFoundation.Framework.Common.MembershipQueryWhat type of membership should be returned for the resulting identities.
Return Value
Type: Microsoft.TeamFoundation.Framework.Server.FilteredIdentitiesList
Implements
.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.