CreateUserWizard::OnCreatingUser Method
Raises the CreatingUser event prior to calling the membership provider to create the new user account.
Assembly: System.Web (in System.Web.dll)
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 InheritorsWhen 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.
The following code example demonstrates a Web page that uses the CustomCreateUserWizard.
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.