Export (0) Print
Expand All

ActiveDirectoryMembershipProvider::UpdateUser Method

Updates information about a user in the Active Directory data store.

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

[DirectoryServicesPermissionAttribute(SecurityAction::Demand, Unrestricted = true)]
[DirectoryServicesPermissionAttribute(SecurityAction::InheritanceDemand, Unrestricted = true)]
[DirectoryServicesPermissionAttribute(SecurityAction::Assert, Unrestricted = true)]
public:
virtual void UpdateUser(
	MembershipUser^ user
) override

Parameters

user
Type: System.Web.Security::MembershipUser

A MembershipUser instance representing the user to update and the updated information for the user.

ExceptionCondition
InvalidOperationException

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

ArgumentNullException

user is nullptr.

- or -

The RequiresUniqueEmail property is true but the email address from the supplied MembershipUser instance is nullptr.

ArgumentException

The Email property is empty after trimming.

- or -

The Email property exceeds 256 characters.

- or -

The Comment property exceeds 1024 characters.

- or -

The Comment property is empty.

- or -

The user name from the supplied MembershipUser instance is empty, or exceeds the maximum length allowed for user names (usually 256 characters).

- or -

The user name from the supplied MembershipUser instance contains commas.

- or -

The user name is mapped to userPrincipalName but the user name from the supplied MembershipUser instance contains backslashes.

ProviderException

The specified user is not found in the Active Directory data store.

- or -

The RequiresUniqueEmail property is true, and the new value of the Email property duplicates an existing e-mail address.

This method is called by the Membership class to update user information in the Active Directory data store. The Email, Comment, and IsApproved property values are updated for the specified membership user. All other properties are ignored.

The maximum length for the username parameter is 256 characters. The maximum length for the Email property is 256 characters.

The password for a membership user cannot be updated using the UpdateUser method. To update the password for a membership user, use the ChangePassword method.

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.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft