CreateUserWizard.OnCreatingUser (Método)
Actualización: noviembre 2007
Provoca el evento CreatingUser antes de llamar al proveedor de suscripciones para crear la nueva cuenta de usuario.
Ensamblado: System.Web (en System.Web.dll)
protected void OnCreatingUser( LoginCancelEventArgs e )
protected function OnCreatingUser( e : LoginCancelEventArgs )
Parámetros
- e
- Tipo: System.Web.UI.WebControls.LoginCancelEventArgs
LoginCancelEventArgs que contiene los datos del evento.
Utilice el método OnCreatingUser para realizar el procesamiento necesario antes de enviar la información del nuevo usuario al método CreateUser del proveedor de suscripciones especificado en la propiedad MembershipProvider. Por ejemplo, puede establecer el campo del nombre de usuario en minúsculas o comparar la dirección de correo electrónico con una lista de direcciones restringidas antes de permitir la creación de la cuenta de usuario.
Si necesita cancelar la solicitud para crear la nueva cuenta de usuario, establezca la propiedad Cancel del objeto LoginCancelEventArgs pasado como parámetro e en true.
Cuando se provoca un evento, se invoca al controlador de eventos por medio de un delegado. Para obtener más información, vea Controlar y provocar eventos.
El método OnCreatingUser también permite que las clases derivadas controlen el evento sin asociar un delegado. Ésta es la técnica preferida para controlar el evento en una clase derivada.
Notas para los herederos:Al reemplazar OnCreatingUser en una clase derivada, asegúrese de llamar al método OnCreatingUser de la clase base para que los delegados registrados reciban el evento.
El ejemplo de código siguiente define un control CreateUserWizard personalizado que utiliza el método OnCreatingUser para convertir la propiedad UserName en minúsculas.
using System; using System.Web; using System.Web.UI.WebControls; using System.Security.Permissions; namespace Samples.AspNet.CS.Controls { [AspNetHostingPermission(System.Security.Permissions.SecurityAction.Demand,Level = AspNetHostingPermissionLevel.Minimal)] [AspNetHostingPermission(System.Security.Permissions.SecurityAction.InheritanceDemand,Level = AspNetHostingPermissionLevel.Minimal)] public class CustomCreateUserWizard : CreateUserWizard { protected override void OnCreatingUser(LoginCancelEventArgs e) { this.UserName.ToLower(); base.OnCreatingUser(e); } } }
En el siguiente ejemplo de código se muestra una página Web que utiliza el CustomCreateUserWizard.
<%@ Page Language="C#"%> <%@ Import namespace="Samples.AspNet.CS.Controls" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <script runat="server"> void Page_Load(object sender, EventArgs e) { CustomCreateUserWizard createUser = new CustomCreateUserWizard(); Placeholder1.Controls.Add(createUser); } </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head id="Head1" runat="server"> <title>CreateUserWizard.OnCreatingUser sample</title> </head> <body> <form id="form1" runat="server"> <div> <asp:placeholder id="Placeholder1" runat="server"> </asp:placeholder> </div> </form> </body> </html>
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
