Export (0) Print
Expand All

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

Adds a new user with specified property values and a unique identifier to the data store and returns a status parameter indicating that the user was successfully created or the reason the user creation failed.

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

public static MembershipUser CreateUser (
	string username,
	string password,
	string email,
	string passwordQuestion,
	string passwordAnswer,
	bool isApproved,
	Object providerUserKey,
	out MembershipCreateStatus status
)
public static MembershipUser CreateUser (
	String username, 
	String password, 
	String email, 
	String passwordQuestion, 
	String passwordAnswer, 
	boolean isApproved, 
	Object providerUserKey, 
	/** @attribute OutAttribute() */ /** @ref */ MembershipCreateStatus status
)
Not applicable.

Parameters

username

The user name for the new user.

password

The password for the new user.

email

The e-mail address for the new user.

passwordQuestion

The password-question value for the membership user.

passwordAnswer

The password-answer value for the membership user.

isApproved

A Boolean that indicates whether the new user is approved to log on.

providerUserKey

The user identifier for the user that should be stored in the membership data store.

status

A MembershipCreateStatus indicating that the user was created successfully or the reason creation failed.

Return Value

A MembershipUser object for the newly created user. If no user was created, this method returns a null reference (Nothing in Visual Basic).

CreateUser adds a new user to the data store and returns a MembershipUser object for the newly created user. If the user creation fails, you can retrieve a MembershipCreateStatus value from the status output parameter that indicates why user creation failed. You can specify a unique identifier for the user, such as a primary key value for a database, by using the providerUserKey parameter.

The CreateUser method will return a null reference (Nothing in Visual Basic) if password is an empty string or a null reference (Nothing in Visual Basic), username is an empty string or a null reference (Nothing in Visual Basic) or contains a comma (,), passwordQuestion is not a null reference (Nothing in Visual Basic) and contains an empty string, or passwordAnswer is not a null reference (Nothing in Visual Basic) and contains an empty string.

Once a membership user has been created and you have a reference to a MembershipUser object for that user, you can modify the settings for that user with the MembershipUser public methods and by setting the property values of the MembershipUser object and then passing the MembershipUser object to the UpdateUser method.

If a user already exists in the data source for the application, you can obtain a MembershipUser object for the existing user with the GetUser method.

Leading and trailing spaces are trimmed from all string parameter values.

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:
© 2014 Microsoft