LoginFailureActionとは何？わかりやすく解説 Weblio辞書

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

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

Login.FailureAction プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ログイン試行が失敗したときに発生するアクションを取得または設定します。

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

Visual Basic (宣言)

<ThemeableAttribute(False)> _
Public Overridable Property
 FailureAction As LoginFailureAction

Visual Basic (使用法)

Dim instance As Login
Dim value As LoginFailureAction

value = instance.FailureAction

instance.FailureAction = value

[ThemeableAttribute(false)] 
public virtual LoginFailureAction FailureAction { get;
 set; }

C++

[ThemeableAttribute(false)] 
public:
virtual property LoginFailureAction FailureAction {
    LoginFailureAction get ();
    void set (LoginFailureAction value);
}

/** @property */
public LoginFailureAction get_FailureAction ()

/** @property */
public void set_FailureAction (LoginFailureAction
 value)

JScript

public function get FailureAction
 () : LoginFailureAction

public function set FailureAction
 (value : LoginFailureAction)

プロパティ値
LoginFailureAction 列挙値の 1 つ。既定値は Refresh です。

例外

例外の種類	条件
HttpException	Web.config に定義されたログインページが存在しません。

解説

FailureAction プロパティは、ユーザーが Web サイトへのログインに失敗した場合の Login コントロールの動作を定義します。

既定の動作では、ページを再読み込みし、FailureText プロパティの内容を表示して、ログイン試行が失敗したことをユーザーに警告します。

FailureAction が RedirectToLoginPage に設定されている場合、ユーザーは Web.config ファイルに定義されたログインページにリダイレクトされます。

このプロパティは、テーマまたはスタイルシートテーマによって設定することはできません。詳細については、ThemeableAttribute、ASP.NET のテーマとスキンの概要の各トピックを参照してください。

使用例

FailureAction プロパティを宣言とコードの両方で設定する方法を次のコード例に示します。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="False"%>
<!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)
    Login1.FailureAction = LoginFailureAction.RedirectToLoginPage
End Sub

</SCRIPT>

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

<%@ Page Language="C#" AutoEventWireup="False"%>
<!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)
{
    Login1.FailureAction = LoginFailureAction.RedirectToLoginPage;
}

</SCRIPT>

<HTML>
    <BODY>
        <FORM runat="server">
            <asp:Login id="Login1" runat="server" FailureAction="RedirectToLoginPage"></asp:Login>
        </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

参照

関連項目
Login クラス
Login メンバ
System.Web.UI.WebControls 名前空間
その他の技術情報
ASP.NET ログインコントロールの概要

LoginFailureAction 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

ログインが失敗したときにユーザーが移動するページを決定します。

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

Visual Basic (宣言)

Public Enumeration LoginFailureAction

Visual Basic (使用法)

Dim instance As LoginFailureAction

public enum LoginFailureAction

C++

public enum class LoginFailureAction

public enum LoginFailureAction

JScript

public enum LoginFailureAction

メンバ

	メンバ名	説明
	RedirectToLoginPage	サイトの構成ファイル (Machine.config および Web.config) で定義されたログインページにユーザーをリダイレクトします。
	Refresh	Login コントロールがエラーメッセージを表示できるように、現在のページを更新します。

使用例

LoginFailureAction 列挙体を使用して、ログインが失敗したときにユーザーを Web.config ファイルで定義されたログインページにリダイレクトするように、FailureAction プロパティを設定する方法を次のコード例に示します。

Visual Basic

<%@ Page Language="VB" AutoEventWireup="False"%>
<!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)
    Login1.FailureAction = LoginFailureAction.RedirectToLoginPage
End Sub

</SCRIPT>

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

<%@ Page Language="C#" AutoEventWireup="False"%>
<!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)
{
    Login1.FailureAction = LoginFailureAction.RedirectToLoginPage;
}

</SCRIPT>

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