Login イベント

名前 | 説明 | |
---|---|---|
![]() | Authenticate | ユーザーが認証されたときに発生します。 |
![]() | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。 ( Control から継承されます。) |
![]() | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。 ( Control から継承されます。) |
![]() | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。 ( Control から継承されます。) |
![]() | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。 ( Control から継承されます。) |
![]() | LoggedIn | ユーザーが Web サイトにログインし、認証されたときに発生します。 |
![]() | LoggingIn | 認証が行われる前に、ユーザーがログイン情報を送信したときに発生します。 |
![]() | LoginError | ログイン エラーが検出された場合に発生します。 |
![]() | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。 ( Control から継承されます。) |
![]() | Unload | サーバー コントロールがメモリからアンロードされると発生します。 ( Control から継承されます。) |

Login クラス
アセンブリ: System.Web (system.web.dll 内)

<BindableAttribute(False)> _ Public Class Login Inherits CompositeControl
[BindableAttribute(false)] public class Login : CompositeControl
BindableAttribute(false) public class Login extends CompositeControl

Login コントロールは、Web サイトでのユーザー認証に必要な共通の UI 要素をすべて提供する複合コントロールです。すべてのログイン シナリオには、次の 3 つの要素が必要です。
Login コントロールには、追加機能をサポートする次のようなオプションの UI 要素も用意されています。
必須コントロールと省略可能なコントロールの一覧については、LayoutTemplate プロパティのトピックを参照してください。
![]() |
---|
Login コントロールを WizardStep オブジェクトに埋め込んだ場合、ユーザーが認証されたら、Page_Load イベント ハンドラで ActiveStepIndex プロパティを明示的に設定します。この場合、Wizard コントロールは次の WizardStep オブジェクトに自動的に進みません。 |
Login コントロールのスタイル プロパティの一覧と、各スタイル プロパティが影響を及ぼす UI 要素の説明を次の表に示します。各スタイルが適用されるプロパティの一覧については、個々のスタイル プロパティに関するドキュメントを参照してください。
BorderPadding | |
CheckBoxStyle | |
FailureTextStyle | |
InstructionTextStyle | |
LabelStyle | |
TextBoxStyle | |
TitleTextStyle | |
ValidatorTextStyle | |
HyperLinkStyle | 他のページへのリンク |
LoginButtonStyle |
検証のグループ化
UserName プロパティと Password プロパティには、ユーザーが必須情報を入力せずにページを送信するのを防ぐ RequiredFieldValidator コントロールが関連付けられています。
Login コントロールは、Login コントロールと同じページ上の他のフィールドを別々に検証できるように、検証グループを使用します。既定では、Login コントロールの ID プロパティが検証グループの名前として使用されます。たとえば、Login コントロールの ID が "Login1" である場合、検証グループの名前にも "Login1" が使用されます。Login コントロールが含まれる検証グループを設定する場合は、そのコントロールのテンプレートを作成し、検証グループ名を変更する必要があります。
このコントロールに既定でレンダリングされるマークアップは、Web Content Accessibility Guidelines (WCAG) 1.0 の優先度 1 ガイドラインなどのユーザー補助に関する標準に適合しない可能性があります。このコントロールのユーザー補助サポートの詳細については、「ASP.NET コントロールとユーザー補助」を参照してください。

Login コントロールを使用して、Web サイトにログインするための UI を提供するコード例を次に示します。
<%@ Page Language="VB" %> <%@ Import Namespace="System.ComponentModel" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <SCRIPT runat="server"> Function IsValidEmail(ByVal strIn As String) As Boolean ' Return true if strIn is in valid e-mail format. Return Regex.IsMatch(strIn, ("^([\w-\.]+)@((\[[0-9]{1 ,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$")) End Function Sub OnLoggingIn(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LoginCancelEventArgs) If Not IsValidEmail(Login1.UserName) Then Login1.InstructionText = "Enter a valid e-mail address." Login1.InstructionTextStyle.ForeColor = System.Drawing.Color.RosyBrown e.Cancel = True Else Login1.InstructionText = String.Empty End If End Sub Sub OnLoginError(ByVal sender As Object, ByVal e As EventArgs) Login1.HelpPageText = "Help with logging in..." Login1.PasswordRecoveryText = "Forgot your password?" End Sub </SCRIPT> <HTML> <BODY> <FORM runat="server"> <asp:Login id="Login1" runat="server" BorderStyle="Solid" BackColor="#F7F7DE" BorderWidth="1px" BorderColor="#CCCC99" Font-Size="10pt" Font-Names="Verdana" CreateUserText="Create a new user..." CreateUserUrl="newUser.aspx" HelpPageUrl="help.aspx" PasswordRecoveryUrl="getPass.aspx" UserNameLabelText="E-mail address:" OnLoggingIn=OnLoggingIn OnLoginError=OnLoginError > <TitleTextStyle Font-Bold="True" ForeColor="#FFFFFF" BackColor="#6B696B"> </TitleTextStyle> </asp:Login> </FORM> </BODY> </HTML>
<%@ Page Language="C#" %> <%@ Import Namespace="System.ComponentModel" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <SCRIPT runat="server"> bool IsValidEmail(string strIn) { // Return true if strIn is in valid e-mail format. return Regex.IsMatch(strIn, @"^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$"); } void OnLoggingIn(object sender, System.Web.UI.WebControls.LoginCancelEventArgs e) { if (!IsValidEmail(Login1.UserName)) { Login1.InstructionText = "Enter a valid e-mail address."; Login1.InstructionTextStyle.ForeColor = System.Drawing.Color.RosyBrown; e.Cancel = true; } else { Login1.InstructionText = String.Empty; } } void OnLoginError(object sender, EventArgs e) { Login1.HelpPageText = "Help with logging in..."; Login1.PasswordRecoveryText = "Forgot your password?"; } </SCRIPT> <HTML> <BODY> <FORM runat="server"> <asp:Login id="Login1" runat="server" BorderStyle="Solid" BackColor="#F7F7DE" BorderWidth="1px" BorderColor="#CCCC99" Font-Size="10pt" Font-Names="Verdana" CreateUserText="Create a new user..." CreateUserUrl="newUser.aspx" HelpPageUrl="help.aspx" PasswordRecoveryUrl="getPass.aspx" UserNameLabelText="E-mail address:" OnLoggingIn=OnLoggingIn OnLoginError=OnLoginError > <TitleTextStyle Font-Bold="True" ForeColor="#FFFFFF" BackColor="#6B696B"> </TitleTextStyle> </asp:Login> </FORM> </BODY> </HTML>
Login コントロールを拡張する方法を次のコード例に示します。CustomLogin コントロールには、認証に使用するメンバシップ プロバイダをユーザーが選択できる DropDownList コントロールが含まれています(これらのプロバイダは、Web.config で設定されます)。OnLoggingIn メソッドで、MembershipProvider プロパティは DropDownList コントロールの選択された値に設定されます。
Imports System Imports System.Data Imports System.Configuration Imports System.Web Imports System.Web.Security Imports System.Web.UI Imports System.Web.UI.WebControls Imports System.Web.UI.WebControls.WebParts Imports System.Web.UI.HtmlControls Namespace Samples.AspNet.Controls NotInheritable Public Class CustomLogin Inherits Login Public Sub New() End Sub 'New Protected Overrides Sub OnLoggingIn(ByVal e As LoginCancelEventArgs) ' Set the Membership provider for the Login control from a DropDownList. Dim list As DropDownList = CType(Me.FindControl("domain"), DropDownList) Me.MembershipProvider = list.SelectedValue MyBase.OnLoggingIn(e) End Sub 'OnLoggingIn Protected Overrides Sub CreateChildControls() LayoutTemplate = New MyTemplate() MyBase.CreateChildControls() End Sub 'CreateChildControls End Class 'CustomLogin ' A Template that contains the child controls. Public Class MyTemplate Implements ITemplate Sub InstantiateIn(ByVal container As Control) Implements ITemplate.InstantiateIn ' A TextBox for the user name. Dim username As New TextBox() username.ID = "username" ' A TextBox for the password. Dim password As New TextBox() password.ID = "password" ' A CheckBox to remember the user on subsequent visits. Dim remember As New CheckBox() remember.ID = "RememberMe" remember.Text = "Don't forget me!" ' Failure Text. Dim failure As New Literal() failure.ID = "FailureText" ' A DropDownList to choose the Membership provider. Dim domain As New DropDownList() domain.ID = "Domain" domain.Items.Add(New ListItem("SqlMembers")) domain.Items.Add(New ListItem("SqlMembers2")) ' A Button to log in. Dim submit As New Button() submit.CommandName = "login" submit.Text = "LOGIN" container.Controls.Add(New LiteralControl("UserName:")) container.Controls.Add(username) container.Controls.Add(New LiteralControl("<br>Password:")) container.Controls.Add(password) container.Controls.Add(New LiteralControl("<br>")) container.Controls.Add(remember) container.Controls.Add(New LiteralControl("<br>Domain:")) container.Controls.Add(domain) container.Controls.Add(New LiteralControl("<br>")) container.Controls.Add(failure) container.Controls.Add(New LiteralControl("<br>")) container.Controls.Add(submit) End Sub 'ITemplate.InstantiateIn End Class 'MyTemplate End Namespace
using System; using System.Data; using System.Configuration; using System.Web; using System.Web.Security; using System.Web.UI; using System.Web.UI.WebControls; using System.Web.UI.WebControls.WebParts; using System.Web.UI.HtmlControls; namespace Samples.AspNet.Controls { public sealed class CustomLogin : Login { public CustomLogin() { } protected override void OnLoggingIn(LoginCancelEventArgs e) { // Set the Membership provider for the Login control from a DropDownList. DropDownList list = (DropDownList)this.FindControl("domain"); this.MembershipProvider = list.SelectedValue; base.OnLoggingIn(e); } protected override void CreateChildControls() { LayoutTemplate = new MyTemplate(); base.CreateChildControls(); } } // A Template that contains the child controls. public class MyTemplate : ITemplate { void ITemplate.InstantiateIn(Control container) { // A TextBox for the user name. TextBox username = new TextBox(); username.ID = "username"; // A TextBox for the password. TextBox password = new TextBox(); password.ID = "password"; // A CheckBox to remember the user on subsequent visits. CheckBox remember = new CheckBox(); remember.ID = "RememberMe"; remember.Text = "Don't forget me!"; // Failure Text. Literal failure = new Literal(); failure.ID = "FailureText"; // A DropDownList to choose the Membership provider. DropDownList domain = new DropDownList(); domain.ID = "Domain"; domain.Items.Add(new ListItem("SqlMembers")); domain.Items.Add(new ListItem("SqlMembers2")); // A Button to log in. Button submit = new Button(); submit.CommandName = "login"; submit.Text = "LOGIN"; container.Controls.Add(new LiteralControl("UserName:")); container.Controls.Add(username); container.Controls.Add(new LiteralControl("<br>Password:")); container.Controls.Add(password); container.Controls.Add(new LiteralControl("<br>")); container.Controls.Add(remember); container.Controls.Add(new LiteralControl("<br>Domain:")); container.Controls.Add(domain); container.Controls.Add(new LiteralControl("<br>")); container.Controls.Add(failure); container.Controls.Add(new LiteralControl("<br>")); container.Controls.Add(submit); } } }


System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.CompositeControl
System.Web.UI.WebControls.Login


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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


Login コンストラクタ
アセンブリ: System.Web (system.web.dll 内)


Login コンストラクタは、プログラムによって Web ページに挿入できる Login コントロールの新しいインスタンスを作成します。
Login の新しいインスタンスの初期プロパティ値を次の表に示します。
RememberMeSet | |
VisibleWhenLoggedIn | |
FailureAction | |
FailureText | |
MembershipProvider | "既定値" |
PasswordLabelText | "パスワード:" |
PasswordRequiredErrorMessage | "パスワードが必要です。" |
RememberMeSet | |
RememberMeText | |
LoginButtonText | "ログイン" |
TextLayout | TextOnLeft |
TitleText | "ログイン" |
UserNameLabelText | "ユーザー名:" |
UserNameRequiredErrorMessage | "ユーザー名が必要です。" |

Login コンストラクタを使用して、Login コントロールの新しいインスタンスを作成し、そのインスタンスを PlaceHolder コントロールの Controls コレクションに追加するコード例を次に示します。
<%@ Page Language="VB" %> <%@ Import Namespace="System.ComponentModel" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <SCRIPT runat="server"> Function IsValidEmail(ByVal strIn As String) As Boolean ' Return true if strIn is in valid e-mail format. Return Regex.IsMatch(strIn, ("^([\w-\.]+)@((\[[0-9]{1 ,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$")) End Function Sub OnLoggingIn(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LoginCancelEventArgs) Dim loginControl As Login loginControl = CType(PlaceHolder1.FindControl("loginControl"), Login) If Not IsValidEmail(loginControl.UserName) Then loginControl.InstructionText = "You must enter a valid e-mail address." e.Cancel = True Else loginControl.InstructionText = String.Empty End If End Sub Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Dim loginControl As New Login loginControl.ID = "loginControl" loginControl.HelpPageText = "Help loggin in..." loginControl.HelpPageUrl = "help.aspx" loginControl.PasswordRecoveryText = "Forgot your password?" loginControl.PasswordRecoveryUrl = "getPass.aspx" AddHandler loginControl.LoggingIn, AddressOf OnLoggingIn PlaceHolder1.Controls.Add(loginControl) End Sub </SCRIPT> <HTML> <BODY> <FORM runat="server"> <asp:PlaceHolder id="PlaceHolder1" runat="server"></asp:PlaceHolder> </FORM> </BODY> </HTML>
<%@ Page Language="C#" %> <%@ Import Namespace="System.ComponentModel" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <SCRIPT runat="server"> bool IsValidEmail(string strIn) { // Return true if strIn is in valid e-mail format. return Regex.IsMatch(strIn, @"^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$"); } void OnLoggingIn(object sender, System.Web.UI.WebControls.LoginCancelEventArgs e) { Login loginControl = (Login)PlaceHolder1.FindControl("loginControl"); if (!IsValidEmail(loginControl.UserName)) { loginControl.InstructionText = "You must enter a valid e-mail address."; e.Cancel = true; } else { loginControl.InstructionText = String.Empty; } } void Page_Load(object sender, EventArgs e) { Login loginControl = new Login(); loginControl.ID = "loginControl"; loginControl.HelpPageText = "Help logging in..."; loginControl.HelpPageUrl = "help.aspx"; loginControl.PasswordRecoveryText = "Forgot your password?"; loginControl.PasswordRecoveryUrl = "getPass.aspx"; loginControl.LoggingIn += new LoginCancelEventHandler(OnLoggingIn); PlaceHolder1.Controls.Add(loginControl); } </SCRIPT> <HTML> <BODY> <FORM runat="server"> <asp:PlaceHolder id="PlaceHolder1" runat="server"></asp:PlaceHolder> </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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


Login フィールド
Login プロパティ



Login メソッド



Login メンバ
Web サイトにログインするためのユーザー インターフェイス (UI: User Interface) 要素を提供します。
Login データ型で公開されるメンバを以下の表に示します。







名前 | 説明 | |
---|---|---|
![]() | Authenticate | ユーザーが認証されたときに発生します。 |
![]() | DataBinding | サーバー コントロールがデータ ソースに連結すると発生します。(Control から継承されます。) |
![]() | Disposed | サーバー コントロールがメモリから解放されると発生します。これは、ASP.NET ページが要求されている場合のサーバー コントロールの有効期間における最終段階です。(Control から継承されます。) |
![]() | Init | サーバー コントロールが初期化されると発生します。これは、サーバー コントロールの有効期間における最初の手順です。(Control から継承されます。) |
![]() | Load | サーバー コントロールが Page オブジェクトに読み込まれると発生します。(Control から継承されます。) |
![]() | LoggedIn | ユーザーが Web サイトにログインし、認証されたときに発生します。 |
![]() | LoggingIn | 認証が行われる前に、ユーザーがログイン情報を送信したときに発生します。 |
![]() | LoginError | ログイン エラーが検出された場合に発生します。 |
![]() | PreRender | Control オブジェクトの読み込み後、表示を開始する前に発生します。(Control から継承されます。) |
![]() | Unload | サーバー コントロールがメモリからアンロードされると発生します。(Control から継承されます。) |

Weblioに収録されているすべての辞書からLog inを検索する場合は、下記のリンクをクリックしてください。

- Log inのページへのリンク