ActiveDirectoryMembershipProvider.GetUser Method (String, Boolean)

Gets the membership user information associated with the specified user name.

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

'Declaration
Public Overrides Function GetUser ( _
	username As String, _
	userIsOnline As Boolean _
) As MembershipUser
'Usage
Dim instance As ActiveDirectoryMembershipProvider
Dim username As String
Dim userIsOnline As Boolean
Dim returnValue As MembershipUser

returnValue = instance.GetUser(username, userIsOnline)
public MembershipUser GetUser (
	String username, 
	boolean userIsOnline
)
public override function GetUser (
	username : String, 
	userIsOnline : boolean
) : MembershipUser
Not applicable.

Parameters

username

The name of the user to get information for.

userIsOnline

The GetUser method ignores this parameter.

Return Value

A MembershipUser instance representing the user specified. If no user is found in the Active Directory data store for the specified username value, a null reference (Nothing in Visual Basic) is returned.

Exception typeCondition

ArgumentException

username is empty, or exceeds the maximum length for the user name (usually 256 characters).

- or -

username contains commas.

- or -

The user name is mapped to the userPrincipalName attribute and the username parameter contains backslashes.

ArgumentNullException

username is a null reference (Nothing in Visual Basic).

InvalidOperationException

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

The GetUser method is called by the Membership class to retrieve information on the specified user from the Active Directory data store.

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.

Leading and trailing spaces are trimmed from the username parameter value.

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: