CreateUserWizard.OnCreatingUser(LoginCancelEventArgs) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
CreatingUser Вызывает событие перед вызовом поставщика членства, чтобы создать новую учетную запись пользователя.
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)Параметры
Содержит LoginCancelEventArgs данные события.
Примеры
В следующем примере кода определяется пользовательский CreateUserWizard элемент управления, использующий OnCreatingUser метод для создания UserName свойства всех строчных регистров.
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
В следующем примере кода показана веб-страница, использующая .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>
Комментарии
OnCreatingUser Используйте метод для выполнения любой обработки, необходимой перед отправкой новой информации CreateUser пользователя методу поставщика членства, указанного в свойствеMembershipProvider. Например, можно задать для поля имени пользователя все строчные буквы или сравнить адрес электронной почты со списком ограниченных адресов, прежде чем разрешить создание учетной записи пользователя.
Если необходимо отменить запрос для создания новой учетной записи пользователя, задайте Cancel для LoginCancelEventArgs свойства объекта, переданного e в качестве параметра true.
При вызове события обработчик событий вызывается через делегат. Дополнительные сведения см. в разделе "Обработка и создание событий".
Метод OnCreatingUser также позволяет производным классам обрабатывать событие без присоединения делегата. Это предпочтительный способ обработки события в производном классе.
Примечания для тех, кто наследует этот метод
При переопределении OnCreatingUser(LoginCancelEventArgs) в производном классе обязательно вызовите метод базового класса OnCreatingUser(LoginCancelEventArgs) , чтобы зарегистрированные делегаты получали событие.
