Export (0) Print
Expand All

ActiveDirectoryMembershipProvider.GetAllUsers Method

Gets a collection of all the users stored in an Active Directory data source.

Namespace: System.Web.Security
Assembly: System.Web (in system.web.dll)

public override MembershipUserCollection GetAllUsers (
	int pageIndex,
	int pageSize,
	out int totalRecords
)
public MembershipUserCollection GetAllUsers (
	int pageIndex, 
	int pageSize, 
	/** @attribute OutAttribute() */ /** @ref */ int totalRecords
)
Not applicable.

Parameters

pageIndex

The index of the page of results to return. pageIndex is zero-based.

pageSize

The size of the page of results to return.

totalRecords

When this method returns, contains the total number of records returned in the collection. This parameter is passed uninitialized.

Return Value

A MembershipUserCollection containing pageSizeMembershipUser instances beginning at the page specified by pageIndex.

Exception typeCondition

InvalidOperationException

The GetAllUsers method is called before the ActiveDirectoryMembershipProvider instance is initialized.

ArgumentException

pageIndex is less than 0.

-or

pageSize is less than 1.

- or -

pageSize multiplied by pageIndex, plus pageSize, minus 1 is greater than MaxValue.

NotSupportedException

The EnableSearchMethods property is false.

This method is called by the Membership class to retrieve user information from the Active Directory data store specified in the ASP.NET application's configuration file.

The results returned by the GetAllUsers method are constrained by the pageIndex and pageSize parameters. The pageSize parameter specifies the maximum number of MembershipUser instances to return in the MembershipUserCollection collection. The pageIndex parameter specifies which page of results to return, where 0 (zero) indicates the first page.

The totalRecords parameter is an out parameter that is set to the total number of matching membership users found in the Active Directory data store. For example, if there are 13 users for the configured data store, and the pageIndex value was 1 with la pageSize of 5, the MembershipUserCollection returned would contain the sixth through the tenth users. The totalRecords parameter would be set to 13.

You can control whether to allow searching for users by setting the EnableSearchMethods property in the application's configuration file using the enableSearchMethods attribute of the membership Element (ASP.NET Settings Schema) element. Setting the EnableSearchMethods property to false causes the GetAllUsers method to throw a NotSupportedException exception.

The provider uses a subtree search starting at the search point specified in the connection string. See the ActiveDirectoryMembershipProvider class topic for more information about connection strings.

We recommend that you do not enable searching on production systems until you have confirmed that the search queries issued by the ActiveDirectoryMembershipProvider class do not adversely impact your directory server's performance. Since the ActiveDirectoryMembershipProvider class is designed for a stateless Web environment, it is unable to use the paging optimizations exposed by the underlying System.DirectoryServices APIs. This means that paging operations during searches against large directories are very expensive and should be avoided. Search operations are always issued against the directory server configured in the connection string, or an automatically selected server in the case of a connection string pointing at a domain. The provider does not use a global catalog for its search methods.

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

ADD
Show:
© 2014 Microsoft