Export (0) Print
Expand All

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

Adds a new user with specified property values 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)

static member CreateUser : 
        username:string * 
        password:string * 
        email:string * 
        passwordQuestion:string * 
        passwordAnswer:string * 
        isApproved:bool * 
        status:MembershipCreateStatus byref -> MembershipUser 

Parameters

username
Type: System.String
The user name for the new user.
password
Type: System.String
The password for the new user.
email
Type: System.String
The e-mail address for the new user.
passwordQuestion
Type: System.String
The password-question value for the membership user.
passwordAnswer
Type: System.String
The password-answer value for the membership user.
isApproved
Type: System.Boolean
A Boolean that indicates whether the new user is approved to log on.
status
Type: System.Web.Security.MembershipCreateStatus%
A MembershipCreateStatus indicating that the user was created successfully or the reason that creation failed.

Return Value

Type: System.Web.Security.MembershipUser
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.

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 is 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.

The following code example creates a new user for an ASP.NET application configured to use forms authentication and ASP.NET membership. If the user is not created successfully, a message is displayed to the user. Otherwise, the user is redirected to the login page for the application.

Security noteSecurity Note

This example contains a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

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.

Community Additions

ADD
Show:
© 2014 Microsoft