ActiveDirectoryMembershipProvider.GetUser Method (String, Boolean)
Gets the membership user information associated with the specified user name.
Assembly: System.Web (in System.Web.dll)
[DirectoryServicesPermissionAttribute(SecurityAction.Assert, Unrestricted = true)] [DirectoryServicesPermissionAttribute(SecurityAction.Demand, Unrestricted = true)] [DirectoryServicesPermissionAttribute(SecurityAction.InheritanceDemand, Unrestricted = true)] public override MembershipUser GetUser( string username, bool userIsOnline )
Parameters
- username
-
Type:
System.String
The name of the user to get information for.
- userIsOnline
-
Type:
System.Boolean
The GetUser method ignores this parameter.
Return Value
Type: System.Web.Security.MembershipUserA MembershipUser instance representing the user specified. If no user is found in the Active Directory data store for the specified username value, null is returned.
| Exception | Condition |
|---|---|
| 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 null. |
| 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.
Available since 2.0