CreateUserWizard.OnCreatingUser(LoginCancelEventArgs) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Déclenche l’événement CreatingUser avant d’appeler le fournisseur d’appartenances pour créer le nouveau compte d’utilisateur.
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 -> unitProtected Overridable Sub OnCreatingUser (e As LoginCancelEventArgs)Paramètres
Contenant LoginCancelEventArgs les données d’événement.
Exemples
L’exemple de code suivant définit un contrôle personnalisé CreateUserWizard qui utilise la OnCreatingUser méthode pour rendre la UserName propriété en minuscules.
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
L’exemple de code suivant illustre une page web qui utilise le 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>
Remarques
Utilisez la OnCreatingUser méthode pour effectuer tout traitement requis avant d’envoyer les nouvelles informations utilisateur à la CreateUser méthode du fournisseur d’appartenance spécifié dans la MembershipProvider propriété. Par exemple, vous pouvez définir le champ nom d’utilisateur sur toutes les lettres minuscules ou comparer l’adresse e-mail à une liste d’adresses restreintes avant d’autoriser la création du compte d’utilisateur.
Si vous devez annuler la demande de création du compte d’utilisateur, définissez la Cancel propriété de l’objet LoginCancelEventArgs passé en tant que e paramètre true.
Le déclenchement d’un événement appelle le gestionnaire d’événements par le biais d’un délégué. Pour plus d’informations, consultez Gestion et déclenchement d’événements.
La OnCreatingUser méthode permet également aux classes dérivées de gérer l’événement sans attacher de délégué. Il s’agit de la technique recommandée pour gérer l’événement dans une classe dérivée.
Notes pour les héritiers
En cas de OnCreatingUser(LoginCancelEventArgs) substitution dans une classe dérivée, veillez à appeler la méthode de OnCreatingUser(LoginCancelEventArgs) la classe de base afin que les délégués inscrits reçoivent l’événement.
