CreateUser Method

MembershipProvider.CreateUser Method (String, String, String, String, String, Boolean, Object, MembershipCreateStatus)


Adds a new membership user to the data source.

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

public abstract MembershipUser CreateUser(
	string username,
	string password,
	string email,
	string passwordQuestion,
	string passwordAnswer,
	bool isApproved,
	object providerUserKey,
	out MembershipCreateStatus status


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
Available since 2.0
Return to top
© 2015 Microsoft