CreateUserWizard.OnCreatingUser(LoginCancelEventArgs) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
CreatingUser Wywołuje zdarzenie przed wywołaniem dostawcy członkostwa w celu utworzenia nowego konta użytkownika.
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)
Parametry
Element LoginCancelEventArgs zawierający dane zdarzenia.
Przykłady
Poniższy przykład kodu definiuje kontrolkę niestandardową CreateUserWizard , która używa OnCreatingUser metody do tworzenia UserName właściwości małymi literami.
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
W poniższym przykładzie kodu pokazano stronę sieci Web, która używa elementu 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>
Uwagi
OnCreatingUser Użyj metody , aby wykonać dowolne przetwarzanie wymagane przed wysłaniem nowych informacji o użytkowniku do CreateUser metody dostawcy członkostwa określonego MembershipProvider we właściwości . Na przykład można ustawić pole nazwy użytkownika na małe litery lub porównać adres e-mail z listą adresów z ograniczeniami przed zezwoleniem na utworzenie konta użytkownika.
Jeśli musisz anulować żądanie utworzenia nowego konta użytkownika, ustaw Cancel właściwość LoginCancelEventArgs obiektu przekazanego jako parametr na e
true
wartość .
Podnoszenie zdarzenia wywołuje program obsługi zdarzeń przez delegata. Aby uzyskać więcej informacji, zobacz Obsługa i podnoszenie zdarzeń.
Metoda OnCreatingUser umożliwia również klasom pochodnym obsługę zdarzenia bez dołączania delegata. Jest to preferowana technika obsługi zdarzenia w klasie pochodnej.
Uwagi dotyczące dziedziczenia
Podczas zastępowania OnCreatingUser(LoginCancelEventArgs) w klasie pochodnej należy wywołać metodę klasy OnCreatingUser(LoginCancelEventArgs) bazowej, aby zarejestrowani delegaci odbierali zdarzenie.