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

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

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

Login.LoggedIn イベント

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

ユーザーが Web サイトにログインし、認証されたときに発生します。

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

Visual Basic (宣言)

Public Event LoggedIn As
 EventHandler

Visual Basic (使用法)

Dim instance As Login
Dim handler As EventHandler

AddHandler instance.LoggedIn, handler

public event EventHandler LoggedIn

C++

public:
event EventHandler^ LoggedIn {
    void add (EventHandler^ value);
    void remove (EventHandler^ value);
}

/** @event */
public void add_LoggedIn (EventHandler value)

/** @event */
public void remove_LoggedIn (EventHandler value)

JScript

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

解説

LoggedIn イベントは、認証プロバイダによってユーザーの資格情報がチェックされ、次の応答でブラウザに送信するために認証 Cookie がキューに置かれた後に発生します。LoggedIn イベントを使用して、ユーザーの認証後にユーザー別データへのアクセスなどの追加処理を行います。

ユーザーがログイン情報を送信すると、Login コントロールは、LoggingIn イベント、Authenticate イベント、LoggedIn イベントの順に発生させます。

メモ
ユーザーが Login コントロールを使用して Web サイトにログインすると、ビューステート内のすべてのデータとすべてのポストデータが失われます。ビューステートに依存する LoggedIn イベントでアクションを実行しないでください。

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

使用例

LoggedIn イベントを使用して、ユーザーのログインレコードを保持するサイト固有のメソッドを呼び出すコード例を次に示します。

Visual Basic

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

<SCRIPT runat="server">
Sub SiteSpecificUserLoggingMethod(ByVal UserName
 As String)
    ' Insert code to record the current date and time
    ' when this user was authenticated at the site.
End Sub

Sub OnLoggedIn(ByVal sender As
 Object, ByVal e As EventArgs)
    SiteSpecificUserLoggingMethod(Login1.UserName)
End Sub
</SCRIPT>

<HTML>
    <BODY>
        <FORM runat="server">
            <asp:Login id="Login1" runat="server"
 OnLoggedIn=OnLoggedIn></asp:Login>

        </FORM>
    </BODY>
</HTML>

<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<SCRIPT runat="server">
void SiteSpecificUserLoggingMethod(string UserName)
{
    // Insert code to record the current date and time
    // when this user was authenticated at the site.
}

void OnLoggedIn(object sender, EventArgs e)
{
    SiteSpecificUserLoggingMethod(Login1.UserName);
}
</SCRIPT>

<HTML>
    <BODY>
        <FORM runat="server">
            <asp:Login id="Login1" runat="server" OnLoggedIn=OnLoggedIn></asp:Login>

        </FORM>
    </BODY>
</HTML>