This documentation is archived and is not being maintained.

MembershipProvider.CreateUser Method

Adds a new membership user to the data source.

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

abstract CreateUser : 
        username:string * 
        password:string * 
        email:string * 
        passwordQuestion:string * 
        passwordAnswer:string * 
        isApproved:bool * 
        providerUserKey:Object * 
        status:MembershipCreateStatus byref -> MembershipUser 


Type: System.String
The user name for the new user.
Type: System.String
The password for the new user.
Type: System.String
The e-mail address for the new user.
Type: System.String
The password question for the new user.
Type: System.String
The password answer for the new user
Type: System.Boolean
Whether or not the new user is approved to be validated.
Type: System.Object
The unique identifier from the membership data source for the user.
Type: System.Web.Security.MembershipCreateStatus%
A MembershipCreateStatus enumeration value indicating whether the user was created successfully.

Return Value

Type: System.Web.Security.MembershipUser
A MembershipUser object populated with the information for the newly created user.

Takes, as input, the name of a new user, a password, and an e-mail address and inserts a new user for the application into the data source. The CreateUser method returns a MembershipUser object populated with the information for the newly created user. The CreateUser method also defines an out parameter (in Visual Basic, you can use ByRef) that returns a MembershipCreateStatus value that indicates that the user was successfully created, or a reason that user creation failed.

The CreateUser method raises the ValidatingPassword event, if a MembershipValidatePasswordEventHandler event handler has been specified, and continues or cancels the create-user action based on the results of the event. You can use the OnValidatingPassword virtual method to execute the specified MembershipValidatePasswordEventHandler event handler.

For an example of a MembershipProvider implementation, see Implementing a Profile Provider.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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