CreateUserWizard.OnCreatingUser(LoginCancelEventArgs) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在调用成员资格提供程序以创建新用户帐户前将引发 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 -> unit
Protected 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在将新用户信息发送到 属性中指定的MembershipProvider成员资格提供程序的 方法之前,CreateUser使用 方法执行所需的任何处理。 例如,可以在允许创建用户帐户之前,将用户名字段设置为所有小写字母,或者将电子邮件地址与受限地址列表进行比较。
如果需要取消创建新用户帐户的请求,请将作为 e
参数传递的 LoginCancelEventArgs 对象的 属性设置为 Canceltrue
。
引发事件时,将通过委托调用事件处理程序。 有关详细信息,请参阅 处理和引发事件。
OnCreatingUser 方法还允许派生类对事件进行处理而不必附加委托。 这是在派生类中处理事件的首选技术。
继承者说明
在派生类中重写 OnCreatingUser(LoginCancelEventArgs) 时,请务必调用基类的 OnCreatingUser(LoginCancelEventArgs) 方法,以便注册的委托接收事件。