Share via

CreateUserWizard.OnCreatingUser(LoginCancelEventArgs) メソッド

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

新しいユーザー アカウントを作成するためにメンバーシップ プロバイダーを呼び出す前に、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)

パラメーター

e
LoginCancelEventArgs

イベント データを格納している LoginCancelEventArgs。

例

次のコード例では、 メソッドを使用OnCreatingUserしてプロパティをすべて小文字にするカスタム CreateUserWizard コントロールを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

次のコード例は、 を使用する Web ページを 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 使用します。 たとえば、ユーザーアカウントの作成を許可する前に、ユーザー名フィールドをすべての小文字に設定したり、電子メール アドレスを制限付きアドレスのリストと比較したりできます。

新しいユーザー アカウントを作成する要求をキャンセルする必要がある場合は、 パラメーターとして渡されるオブジェクトの LoginCancelEventArgs プロパティを e にtrue設定Cancelします。

イベントを発生させると、イベント ハンドラーがデリゲートから呼び出されます。 詳細については、処理とイベントの発生 を参照してください。

OnCreatingUser メソッドを使用すると、デリゲートを結び付けずに、派生クラスでイベントを処理することもできます。 派生クラスでイベントを処理する場合は、この手法をお勧めします。

注意 (継承者)

派生クラスでオーバーライドする OnCreatingUser(LoginCancelEventArgs) 場合は、登録されたデリゲートがイベントを受け取るように、基底クラスの OnCreatingUser(LoginCancelEventArgs) メソッドを必ず呼び出してください。

適用対象

こちらもご覧ください