ChangePassword.ChangingPassword イベントとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ChangePassword.ChangingPassword イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザーアカウントのパスワードがメンバシッププロバイダによって変更される前に発生します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Event ChangingPassword As
 LoginCancelEventHandler

Visual Basic (使用法)

Dim instance As ChangePassword
Dim handler As LoginCancelEventHandler

AddHandler instance.ChangingPassword, handler

public event LoginCancelEventHandler ChangingPassword

C++

public:
event LoginCancelEventHandler^ ChangingPassword {
    void add (LoginCancelEventHandler^ value);
    void remove (LoginCancelEventHandler^ value);
}

/** @event */
public void add_ChangingPassword (LoginCancelEventHandler
 value)

/** @event */
public void remove_ChangingPassword (LoginCancelEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

ChangingPassword イベントは、ユーザーアカウントのパスワードを変更するために、MembershipProvider プロパティで指定したメンバシッププロバイダが呼び出される前に発生します。

ChangingPassword イベントを使用して、新しいパスワードをチェックして一般的なパスワードのリストに含まれないことを確認するなど、パスワードを変更する前に必要な処理を実行します。ChangingPassword イベントの後、ChangedPassword イベントの前に、ユーザーの新しい承認トークンが設定されます。

ChangingPassword イベントは、イベントハンドラがメンバシッププロバイダを呼び出すべきではないと判断した場合、LoginCancelEventArgs オブジェクトの Cancel プロパティを true に設定することでキャンセルできます。

イベント処理の詳細については、「イベントの処理と発生」を参照してください。

使用例

ChangePassword コントロールを使用し、ChangingPassword という名前の ChangingPassword イベントのハンドラを含む ASP.NET ページを使用する方法を次のコード例に示します。このイベントハンドラのコードは、CurrentPassword プロパティに格納されている古いパスワードと NewPassword に格納されている新しいパスワードとを比較します。2 つのパスワードが同じ場合、パスワードの変更は失敗します。

ChangePassword コントロールでは、ユーザーが自分のユーザー名を入力できるように、DisplayUserName プロパティが true に設定されます。つまり、ユーザーはログオンしてページを表示する必要がありません。

このコード例では、ASP.NET メンバシップとフォーム認証を使用するように構成された ASP.NET Web サイトと、名前とパスワードがわかっているユーザーが作成されていることを前提にしています。詳細については、「方法 : 簡単なフォーム認証を実装する」を参照してください。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="True"
 %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML
 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Public Sub PageLoad(ByVal
 Sender As Object, ByVal
 e As EventArgs)
    'Manually register the event-handling methods.
    AddHandler ChangePassword1.ChangingPassword, AddressOf
 Me._ChangingPassword
  End Sub

  Public Sub _ChangingPassword(ByVal
 Sender As Object, ByVal
 e As LoginCancelEventArgs)
    If (ChangePassword1.CurrentPassword.ToString() = ChangePassword1.NewPassword.ToString)
 Then
      Message1.Visible = True
      Message1.Text = "Old password and new password must be different.
  Please try again."
      e.Cancel = True
    Else
      'This line prevents the error showing up after a first failed
 attempt.
      Message1.Visible = False
    End If
  End Sub

</script>

<html  >
<head runat="server">
  <title>ChangePassword including a ChangingPassword event
 handler</title>
</head>
<body>
  <form id="form1" runat="server">
  <div align="center">

    <h1>ChangePassword</h1>
    
    <asp:LoginView ID="LoginView1" Runat="server"
 
      Visible="true">
      <LoggedInTemplate>
        <asp:LoginName ID="LoginName1" Runat="server"
 FormatString="You are logged in as {0}." />
        <BR />
      </LoggedInTemplate>
      <AnonymousTemplate>
        You are not logged in
      </AnonymousTemplate>
    </asp:LoginView><br />
    
    <asp:ChangePassword ID="ChangePassword1" Runat="server"
      BorderStyle="Solid" 
      BorderWidth="1" 
      CancelDestinationPageUrl="~/Default.aspx" 
      DisplayUserName="true" 
      OnChangingPassword="_ChangingPassword"
      ContinueDestinationPageUrl="~/Default.aspx"
 >
    </asp:ChangePassword><br />
  
    <asp:Label ID="Message1" Runat="server"
 ForeColor="Red" /><br />

    <asp:HyperLink ID="HyperLink1" Runat="server"
 
      NavigateUrl="~/Default.aspx">
      Home
    </asp:HyperLink>
    
  </div>
  </form>
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>

<script runat="server">

  void Page_Load(Object sender, EventArgs e)
  {
    //Manually register the event-handling methods.
    ChangePassword1.ChangingPassword += new LoginCancelEventHandler(this._ChangingPassword);
  }

  void _ChangingPassword(Object sender, LoginCancelEventArgs e)
  {
    if (ChangePassword1.CurrentPassword.ToString() == ChangePassword1.NewPassword.ToString())
    {
      Message1.Visible = true;
      Message1.Text = "Old password and new password must
 be different.  Please try again.";
      e.Cancel = true;
    }
    else
    {
      //This line prevents the error showing up after a first failed
 attempt.
      Message1.Visible = false;
    }
  }

</script>

<html  >
<head runat="server">
  <title>ChangePassword including a ChangingPassword event handler</title>
</head>
<body>
  <form id="form1" runat="server">
  <div align="center">

    <h1>ChangePassword</h1>
    
    <asp:LoginView ID="LoginView1" Runat="server" 
      Visible="true">
      <LoggedInTemplate>
        <asp:LoginName ID="LoginName1" Runat="server" FormatString="You
 are logged in as {0}." />
        <BR />
      </LoggedInTemplate>
      <AnonymousTemplate>
        You are not logged in
      </AnonymousTemplate>
    </asp:LoginView><br />
    
    <asp:ChangePassword ID="ChangePassword1" Runat="server"
      BorderStyle="Solid" 
      BorderWidth="1" 
      CancelDestinationPageUrl="~/Default.aspx" 
      DisplayUserName="true" 
      OnChangingPassword="_ChangingPassword"
      ContinueDestinationPageUrl="~/Default.aspx" >
    </asp:ChangePassword><br />
  
    <asp:Label ID="Message1" Runat="server" ForeColor="Red"
 /><br />

    <asp:HyperLink ID="HyperLink1" Runat="server" 
      NavigateUrl="~/Default.aspx">
      Home
    </asp:HyperLink>
    
  </div>
  </form>
</body>
</html>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ChangePassword クラス
ChangePassword メンバ
System.Web.UI.WebControls 名前空間
OnChangingPassword
その他の技術情報
ASP.NET Web ページのサーバーイベント処理
ASP.NET ログインコントロールの概要
ASP.NET ログインコントロールの外観のカスタマイズ
ASP.NET Web サーバーコントロールテンプレート
方法 : 匿名ユーザーおよびログインユーザーに異なる情報を表示する
Web サイト管理ツールの [セキュリティ] タブ
ログインコントロールのセキュリティ保護
Web アプリケーションのセキュリティに関する基本的な対策
メンバシップのセキュリティ保護

>> 「ChangePassword.ChangingPassword イベント」を含む用語の索引
ChangePassword.ChangingPassword イベントのページへのリンク


	© 2024 Microsoft.All rights reserved.

ChangePassword.ChangingPassword イベントとは？ わかりやすく解説

ChangePassword.ChangingPassword イベント

急上昇のことば

ChangePassword.ChangingPassword イベントとは？わかりやすく解説