CreateUserWizard::OnCreatingUser Method (LoginCancelEventArgs^)

 

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.

.NET Framework
Available since 2.0
Return to top
Show: