CreateUserWizard.OnCreatingUser(LoginCancelEventArgs) Método

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Aciona o evento CreatingUser antes de chamar o provedor de associação para criar a nova conta de usuário.

protected:
 virtual void OnCreatingUser(System::Web::UI::WebControls::LoginCancelEventArgs ^ e);

protected virtual void OnCreatingUser (System.Web.UI.WebControls.LoginCancelEventArgs e);

abstract member OnCreatingUser : System.Web.UI.WebControls.LoginCancelEventArgs -> unit
override this.OnCreatingUser : System.Web.UI.WebControls.LoginCancelEventArgs -> unit

Protected Overridable Sub OnCreatingUser (e As LoginCancelEventArgs)

Parâmetros

e: LoginCancelEventArgs

Um LoginCancelEventArgs que contém os dados de evento.

Exemplos

O exemplo de código a seguir define um controle personalizado CreateUserWizard que usa o OnCreatingUser método para tornar a UserName propriedade toda minúscula.

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);
    }
  }
}

Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls
  <AspNetHostingPermission(System.Security.Permissions.SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(System.Security.Permissions.SecurityAction.InheritanceDemand, Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class CustomCreateUserWizard
    Inherits CreateUserWizard
    
    Overloads Sub OnCreatingUser(ByVal e As LoginCancelEventArgs)
      Me.UserName.ToLower()
      MyBase.OnCreatingUser(e)
    End Sub    
    
  End Class
End Namespace

O exemplo de código a seguir demonstra uma página da Web que usa o 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>

<%@ Page Language="VB"%>
<%@ Import namespace="Samples.AspNet.VB.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  
  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
    Dim createUser As New CustomCreateUserWizard
    Placeholder1.Controls.Add(createUser)
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head 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>

Comentários

Use o OnCreatingUser método para fazer qualquer processamento necessário antes de enviar as novas informações de usuário para o CreateUser método do provedor de associação especificado na MembershipProvider propriedade . Por exemplo, você pode definir o campo nome de usuário para todas as letras minúsculas ou comparar o endereço de email com uma lista de endereços restritos antes de permitir a criação da conta de usuário.

Se você precisar cancelar a solicitação para criar a nova conta de usuário, defina a Cancel propriedade do LoginCancelEventArgs objeto passado como o e parâmetro como true.

A geração de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações, consulte Manipulando e levantando eventos.

O OnCreatingUser método também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.

Notas aos Herdeiros

Ao substituir OnCreatingUser(LoginCancelEventArgs) em uma classe derivada, chame o método da OnCreatingUser(LoginCancelEventArgs) classe base para que os delegados registrados recebam o evento.

Aplica-se a

Partilhar via