This documentation is archived and is not being maintained.

CreateUserWizard::OnCreatingUser Method

Raises the CreatingUser event prior to calling the membership provider to create the new user account.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

protected:
virtual void OnCreatingUser(
	LoginCancelEventArgs^ e
)

Parameters

e
Type: System.Web.UI.WebControls::LoginCancelEventArgs

A LoginCancelEventArgs containing the event data.

Use the OnCreatingUser method to do any processing required before sending the new user information to the CreateUser method of the membership provider specified in the MembershipProvider property. For example, you might set the user name field to all lowercase letters, or compare the e-mail address to a list of restricted addresses before allowing creation of the user account.

If you need to cancel the request to create the new user account, set the Cancel property of the LoginCancelEventArgs object passed as the e parameter to true.

Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.

The OnCreatingUser method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors:

When overriding OnCreatingUser in a derived class, be sure to call the base class’s OnCreatingUser method so that registered delegates receive the event.

The following code example defines a custom CreateUserWizard control that uses the OnCreatingUser method to make the UserName property all lowercase.

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

The following code example demonstrates a Web page that uses the CustomCreateUserWizard.

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

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: