Login クラス

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

Web サイトにログインするためのユーザーインターフェイス (UI) 要素を提供します。

public ref class Login : System::Web::UI::WebControls::CompositeControl

[System.ComponentModel.Bindable(false)]
public class Login : System.Web.UI.WebControls.CompositeControl

[<System.ComponentModel.Bindable(false)>]
type Login = class
    inherit CompositeControl

Public Class Login
Inherits CompositeControl

継承: Object

Control

WebControl

CompositeControl
Login

属性: BindableAttribute

例

次のコード例では、 Login コントロールを使用して、Web サイトにログインするための UI を提供します。

<%@ 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 email 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 email 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 xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" 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="Email address:" 
                OnLoggingIn="OnLoggingIn"
                OnLoginError="OnLoginError" >
                <TitleTextStyle Font-Bold="True" 
                    ForeColor="#FFFFFF" 
                    BackColor="#6B696B">
                </TitleTextStyle>
            </asp:Login>

        </form>
    </body>
</html>

<%@ 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 email 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 email 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 xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" 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="Email 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 コントロールの選択した値に設定されます。

Important

この例には、潜在的なセキュリティ上の脅威であるユーザー入力を受け入れるテキストボックスが含まれています。既定では、ASP.NET Web ページでは、ユーザー入力にスクリプトや HTML 要素が含まれていないことが検証されます。詳細については、「スクリプトの悪用の概要」を参照してください。

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);
        }
    }    
}

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

        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


        Protected Overrides Sub CreateChildControls() 

            LayoutTemplate = New MyTemplate()
            MyBase.CreateChildControls()

        End Sub
    End Class

    ' 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
    End Class
End Namespace

注釈

このトピックの内容は以下のとおりです。

Introduction
スタイルとテンプレート
検証グループ
アクセシビリティ
CSS スタイルの適用
宣言構文

はじめに

ユーザーを識別する一意のユーザー名。
ユーザーの ID を確認するためのパスワード。
ログイン情報をサーバーに送信するログインボタン。

パスワードアラームのリンク。
セッション間でログイン情報を保持するための [記憶する] チェックボックス。
ログインに問題があるユーザーのヘルプリンク。
ユーザーを登録ページにリダイレクトする [新しいユーザーの登録] リンク。
ログインフォームに表示される指示テキスト。
ユーザー名またはパスワードのフィールドを入力せずにログインボタンをクリックしたときに表示されるカスタムエラーテキスト。
ログインに失敗した場合に表示されるカスタムエラーテキスト。
ログインが成功したときに発生するカスタムアクション。
ユーザーが既にサイトにログインしている場合にログインコントロールを非表示にする方法。

必要なコントロールと省略可能なコントロールを示す表については、「 LayoutTemplate プロパティ」を参照してください。

注

ASP.NET で使用できるログインコントロールのセットに慣れていない場合は、先に進む前にログインコントロールの概要 ASP.NET 参照してください。ログインコントロールとメンバーシップに関連するその他のトピックの一覧については、「メンバーシップを使用したユーザーの管理」を参照してください。

Important

ユーザー入力を受け入れることは、潜在的なセキュリティ上の脅威です。悪意のあるユーザーは、脆弱性を公開することを目的としたデータを送信したり、生成されたパスワードを試みるプログラムを実行したりすることができます。ユーザー入力を操作するときのセキュリティを強化するには、コントロールの検証機能を使用し、コントロール用に構成されているデータプロバイダーをセキュリティで保護する必要があります。詳細については、「ログイン制御のセキュリティ保護」、 Web アプリケーションの基本的なセキュリティプラクティス、およびメンバーシップのセキュリティ保護に関するページを参照してください。

Login コントロールは、メンバーシッププロバイダーを使用してユーザー資格情報を取得します。特に指定しない限り、 Login コントロールは、Web.config ファイルで定義されている既定のメンバーシッププロバイダーを使用します。別のプロバイダーを指定するには、 MembershipProvider プロパティを、アプリケーションの Web.config ファイルで定義されているメンバーシッププロバイダー名のいずれかに設定します。詳細については、「メンバーシッププロバイダー」を参照してください。

カスタム認証サービスを使用する場合は、 OnAuthenticate メソッドを使用してサービスを呼び出すことができます。

スタイルとテンプレート

Login コントロールの外観は、テンプレートとスタイル設定を使用して完全にカスタマイズできます。すべての UI テキストメッセージは、 Login クラスのプロパティを使用してカスタマイズすることもできます。既定のインターフェイステキストは、サーバーのロケール設定に基づいて自動的にローカライズされます。

Login コントロールがテンプレートでカスタマイズされている場合、AccessKey プロパティと TabIndex プロパティは無視されます。この場合は、各テンプレート子コントロールの AccessKey プロパティと TabIndex プロパティを直接設定します。

Login UserNameやPasswordなどのテキストボックスで表されるコントロールプロパティは、ページライフサイクルのすべてのフェーズでアクセスできます。コントロールは、テキストボックスによってトリガーされる TextChanged イベントを使用して、エンドユーザーによって行われたすべての変更を取得します。

注

Login コントロールをWizardStep オブジェクトに埋め込む場合は、ユーザーが認証されている場合は、Page_Load イベントハンドラーで ActiveStepIndex プロパティを明示的に設定します。このシナリオでは、 Wizard コントロールは自動的に次の WizardStep オブジェクトに進むことはありません。

次の表に、 Login コントロールのスタイルプロパティの一覧を示し、各スタイルプロパティが影響を受ける UI 要素について説明します。各スタイルが適用されるプロパティの一覧については、個々のスタイルプロパティのドキュメントを参照してください。

Style プロパティ	影響を受ける UI 要素
BorderPadding	コントロールの内容とコントロールの境界線の間のスペース。
CheckBoxStyle	[自分を記憶する] チェックボックス。
FailureTextStyle	ログインエラーのテキスト。
InstructionTextStyle	コントロールの使用方法をユーザーに伝えるページ上の説明テキスト。
LabelStyle	テキストボックスなど、すべての入力フィールドのラベル。
TextBoxStyle	テキスト入力フィールド。
TitleTextStyle	タイトルテキスト。
ValidatorTextStyle	検証エラーが原因でログイン試行が失敗したときにユーザーに表示されるテキスト。
HyperLinkStyle	他のページへのリンク。
LoginButtonStyle	[ログイン] ボタン。

検証グループ

UserNameプロパティとPassword プロパティには、ユーザーが必要な情報を指定せずにページを送信できないように、RequiredFieldValidator コントロールが関連付けられています。

Login コントロールは検証グループを使用するため、Login コントロールと同じページ上の他のフィールドを個別に検証できます。既定では、Login コントロールのID プロパティが検証グループの名前として使用されます。たとえば、ID "Login1" の Login コントロールでは、検証グループ名 "Login1" が使用されます。 Login コントロールが含まれる検証グループを設定する場合は、コントロールをテンプレート化し、検証グループ名を変更する必要があります。

CSS スタイルの適用

Login コントロールを使用すると、マークアップで CSS スタイルルールを指定できます。テンプレートを使用して Login コントロールの外観をカスタマイズする場合は、テンプレートのマークアップで CSS スタイルを指定できます。その場合、余分な外部テーブルは必要ありません。 RenderOuterTable プロパティを false に設定すると、テーブルがレンダリングされないようにすることができます。

アクセシビリティ

アクセシビリティ標準に準拠するマークアップを生成するようにこのコントロールを構成する方法については、「 Visual Studio のアクセシビリティ」および「ASP.NET および ASP.NET コントロールとアクセシビリティ」を参照してください。

宣言構文

<asp:Login
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderPadding="integer"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CreateUserIconUrl="uri"
    CreateUserText="string"
    CreateUserUrl="uri"
    CssClass="string"
    DestinationPageUrl="uri"
    DisplayRememberMe="True|False"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FailureAction="Refresh|RedirectToLoginPage"
    FailureText="string"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
               Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    HelpPageIconUrl="uri"
    HelpPageText="string"
    HelpPageUrl="uri"
    ID="string"
    InstructionText="string"
    LoginButtonImageUrl="uri"
    LoginButtonText="string"
    LoginButtonType="Button|Image|Link"
    MembershipProvider="string"
    OnAuthenticate="Authenticate event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnLoggedIn="LoggedIn event handler"
    OnLoggingIn="LoggingIn event handler"
    OnLoginError="LoginError event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    Orientation="Horizontal|Vertical"
    PasswordLabelText="string"
    PasswordRecoveryIconUrl="uri"
    PasswordRecoveryText="string"
    PasswordRecoveryUrl="uri"
    PasswordRequiredErrorMessage="string"
    RememberMeSet="True|False"
    RememberMeText="string"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    TextLayout="TextOnLeft|TextOnTop"
    TitleText="string"
    ToolTip="string"
    UserName="string"
    UserNameLabelText="string"
    UserNameRequiredErrorMessage="string"
    Visible="True|False"
    VisibleWhenLoggedIn="True|False"
    Width="size"
>
        <CheckBoxStyle />
        <FailureTextStyle />
        <HyperLinkStyle />
        <InstructionTextStyle />
        <LabelStyle />
        <LayoutTemplate>
            <!-- child controls -->
        </LayoutTemplate>
        <LoginButtonStyle />
        <TextBoxStyle />
        <TitleTextStyle />
        <ValidatorTextStyle />
</asp:Login>

コンストラクター

名前	説明
Login()	Login コントロールの新しいインスタンスを作成します。

フィールド

名前	説明
LoginButtonCommandName	ログインボタンに関連付けられているコマンド名を表します。

プロパティ

名前	説明
AccessKey	Web サーバーコントロールにすばやく移動できるアクセスキーを取得または設定します。 (継承元 WebControl)
Adapter	コントロールのブラウザー固有のアダプターを取得します。 (継承元 Control)
AppRelativeTemplateSourceDirectory	このコントロールを含む Page または UserControl オブジェクトのアプリケーション相対仮想ディレクトリを取得または設定します。 (継承元 Control)
Attributes	コントロールのプロパティに対応しない任意の属性のコレクションを取得します (レンダリングのみ)。 (継承元 WebControl)
BackColor	Web サーバーコントロールの背景色を取得または設定します。 (継承元 WebControl)
BindingContainer	このコントロールのデータバインディングを含むコントロールを取得します。 (継承元 Control)
BorderColor	Web コントロールの境界線の色を取得または設定します。 (継承元 WebControl)
BorderPadding	Login コントロールの境界線内のパディングの量を取得または設定します。
BorderStyle	Web サーバーコントロールの境界線スタイルを取得または設定します。 (継承元 WebControl)
BorderWidth	Web サーバーコントロールの境界線の幅を取得または設定します。 (継承元 WebControl)
CheckBoxStyle	[記憶する] チェックボックスの設定を定義する Style オブジェクトへの参照を取得します。
ChildControlsCreated	サーバーコントロールの子コントロールが作成されているかどうかを示す値を取得します。 (継承元 Control)
ClientID	ASP.NET によって生成される HTML マークアップのコントロール ID を取得します。 (継承元 Control)
ClientIDMode	ClientID プロパティの値を生成するために使用するアルゴリズムを取得または設定します。 (継承元 Control)
ClientIDSeparator	ClientID プロパティで使用される区切り文字を表す文字値を取得します。 (継承元 Control)
Context	現在の Web 要求のサーバーコントロールに関連付けられている HttpContext オブジェクトを取得します。 (継承元 Control)
Controls	CompositeControl内の子コントロールを表すControlCollection オブジェクトを取得します。 (継承元 CompositeControl)
ControlStyle	Web サーバーコントロールのスタイルを取得します。このプロパティは、主にコントロール開発者によって使用されます。 (継承元 WebControl)
ControlStyleCreated	ControlStyle プロパティに対してStyle オブジェクトが作成されたかどうかを示す値を取得します。このプロパティは、主にコントロール開発者によって使用されます。 (継承元 WebControl)
CreateUserIconUrl	新しいユーザーの登録ページへのリンクの横に表示する画像の場所を取得します。
CreateUserText	新しいユーザーの登録ページへのリンクのテキストを取得または設定します。
CreateUserUrl	新規ユーザー登録ページの URL を取得または設定します。
CssClass	クライアント上の Web サーバーコントロールによってレンダリングされるカスケードスタイルシート (CSS) クラスを取得または設定します。 (継承元 WebControl)
DataItemContainer	名前付けコンテナーが IDataItemContainerを実装する場合は、名前付けコンテナーへの参照を取得します。 (継承元 Control)
DataKeysContainer	名前付けコンテナーが IDataKeysControlを実装する場合は、名前付けコンテナーへの参照を取得します。 (継承元 Control)
DesignMode	コントロールがデザインサーフェイスで使用されているかどうかを示す値を取得します。 (継承元 Control)
DestinationPageUrl	ログイン試行が成功したときにユーザーに表示されるページの URL を取得または設定します。
DisplayRememberMe	ユーザーが永続的な Cookie をブラウザーに送信するかどうかを制御できるようにするためのチェックボックスを表示するかどうかを示す値を取得または設定します。
Enabled	Web サーバーコントロールが有効かどうかを示す値を取得または設定します。 (継承元 WebControl)
EnableTheming	テーマがこのコントロールに適用されるかどうかを示す値を取得または設定します。 (継承元 WebControl)
EnableViewState	サーバーコントロールがそのビューステートを保持するかどうか、およびそれに含まれる子コントロールのビューステートを要求側クライアントに保持するかどうかを示す値を取得または設定します。 (継承元 Control)
Events	コントロールのイベントハンドラーデリゲートの一覧を取得します。このプロパティは読み取り専用です。 (継承元 Control)
FailureAction	ログイン試行が失敗したときに発生するアクションを取得または設定します。
FailureText	ログイン試行が失敗したときに表示されるテキストを取得または設定します。
FailureTextStyle	Login コントロール内のエラーテキストの外観を定義するプロパティのコレクションへの参照を取得します。
Font	Web サーバーコントロールに関連付けられているフォントプロパティを取得します。 (継承元 WebControl)
ForeColor	Web サーバーコントロールの前景色 (通常はテキストの色) を取得または設定します。 (継承元 WebControl)
HasAttributes	コントロールに属性が設定されているかどうかを示す値を取得します。 (継承元 WebControl)
HasChildViewState	現在のサーバーコントロールの子コントロールに保存されたビューステート設定があるかどうかを示す値を取得します。 (継承元 Control)
Height	Web サーバーコントロールの高さを取得または設定します。 (継承元 WebControl)
HelpPageIconUrl	ログインヘルプページへのリンクの横に表示する画像の場所を取得します。
HelpPageText	ログインヘルプページへのリンクのテキストを取得または設定します。
HelpPageUrl	ログインヘルプページの URL を取得または設定します。
HyperLinkStyle	Login コントロール内のハイパーリンクの外観を定義するプロパティのコレクションへの参照を取得します。
ID	サーバーコントロールに割り当てられたプログラム識別子を取得または設定します。 (継承元 Control)
IdSeparator	コントロール識別子を分離するために使用する文字を取得します。 (継承元 Control)
InstructionText	ユーザーのログイン命令テキストを取得または設定します。
InstructionTextStyle	Login コントロール内の命令テキストの設定を定義するTableItemStyle オブジェクトへの参照を取得します。
IsChildControlStateCleared	このコントロール内に含まれるコントロールがコントロールの状態を持っているかどうかを示す値を取得します。 (継承元 Control)
IsEnabled	コントロールが有効かどうかを示す値を取得します。 (継承元 WebControl)
IsTrackingViewState	サーバーコントロールがビューステートへの変更を保存するかどうかを示す値を取得します。 (継承元 Control)
IsViewStateEnabled	このコントロールに対してビューステートが有効かどうかを示す値を取得します。 (継承元 Control)
LabelStyle	コントロールラベルの設定を定義する TableItemStyle オブジェクトへの参照 Login 取得します。
LayoutTemplate	Login コントロールの表示に使用するテンプレートを取得または設定します。
LoadViewStateByID	インデックスの代わりに ID して、コントロールがビューステートの読み込みに関与するかどうかを示す値を取得します。 (継承元 Control)
LoginButtonImageUrl	ログインボタンに使用するイメージの URL を取得または設定します。
LoginButtonStyle	Login コントロールのログインボタンの外観を設定できるStyle オブジェクトへの参照を取得します。
LoginButtonText	Login コントロールのログインボタンのテキストを取得または設定します。
LoginButtonType	Login ボタンをレンダリングするときに使用するボタンの種類を取得または設定します。
MembershipProvider	コントロールによって使用されるメンバーシップデータプロバイダーの名前を取得または設定します。
NamingContainer	同じ ID プロパティ値を持つサーバーコントロール間で区別するための一意の名前空間を作成する、サーバーコントロールの名前付けコンテナーへの参照を取得します。 (継承元 Control)
Orientation	ページ上の Login コントロールの要素の位置を指定する値を取得または設定します。
Page	サーバーコントロールを含む Page インスタンスへの参照を取得します。 (継承元 Control)
Parent	ページコントロール階層内のサーバーコントロールの親コントロールへの参照を取得します。 (継承元 Control)
Password	ユーザーが入力したパスワードを取得します。
PasswordLabelText	Password テキストボックスのラベルのテキストを取得または設定します。
PasswordRecoveryIconUrl	パスワード回復ページへのリンクの横に表示するイメージの場所を取得します。
PasswordRecoveryText	パスワード回復ページへのリンクのテキストを取得または設定します。
PasswordRecoveryUrl	パスワード回復ページの URL を取得または設定します。
PasswordRequiredErrorMessage	パスワードフィールドが空白の場合に ValidationSummary コントロールに表示するエラーメッセージを取得または設定します。
RememberMeSet	ユーザーのブラウザーに永続的な認証 Cookie を送信するかどうかを示す値を取得または設定します。
RememberMeText	[記憶する] チェックボックスのラベルのテキストを取得または設定します。
RenderingCompatibility	レンダリングされた HTML と互換性のある ASP.NET バージョンを指定する値を取得します。 (継承元 Control)
RenderOuterTable	インラインスタイルを適用するために、レンダリングされた HTML を `table` 要素で囲むかどうかを示す値を取得または設定します。
Site	デザインサーフェイスにレンダリングされるときに、現在のコントロールをホストするコンテナーに関する情報を取得します。 (継承元 Control)
SkinID	コントロールに適用するスキンを取得または設定します。 (継承元 WebControl)
Style	Web サーバーコントロールの外部タグのスタイル属性としてレンダリングされるテキスト属性のコレクションを取得します。 (継承元 WebControl)
SupportsDisabledAttribute	コントロールのIsEnabled プロパティが`false`されたときに、レンダリングされた HTML 要素の`disabled`属性を "無効" に設定する必要があるかどうかを示す値を取得します。 (継承元 CompositeControl)
TabIndex	Web サーバーコントロールのタブインデックスを取得または設定します。 (継承元 WebControl)
TagKey	Login コントロールに対応するHtmlTextWriterTag値を取得します。このプロパティは、主にコントロール開発者によって使用されます。
TagName	コントロールタグの名前を取得します。このプロパティは、主にコントロール開発者によって使用されます。 (継承元 WebControl)
TemplateControl	このコントロールを含むテンプレートへの参照を取得または設定します。 (継承元 Control)
TemplateSourceDirectory	現在のサーバーコントロールを含む Page または UserControl の仮想ディレクトリを取得します。 (継承元 Control)
TextBoxStyle	Login コントロール内のテキストボックスの外観を定義するプロパティのコレクションへの参照を取得します。
TextLayout	Login コントロールに関連付けられているテキストボックスを基準にした各ラベルの位置を指定します。
TitleText	Login コントロールのタイトルを取得または設定します。
TitleTextStyle	Login コントロール内のタイトルテキストの外観を定義するプロパティのコレクションへの参照を取得します。
ToolTip	マウスポインターが Web サーバーコントロールの上に置いたときに表示されるテキストを取得または設定します。 (継承元 WebControl)
UniqueID	サーバーコントロールの階層的に修飾された一意の識別子を取得します。 (継承元 Control)
UserName	ユーザーが入力したユーザー名を取得します。
UserNameLabelText	UserName テキストボックスのラベルのテキストを取得または設定します。
UserNameRequiredErrorMessage	ユーザー名フィールドが空白の場合に ValidationSummary コントロールに表示するエラーメッセージを取得または設定します。
ValidateRequestMode	コントロールがブラウザーからのクライアント入力で潜在的に危険な値をチェックするかどうかを示す値を取得または設定します。 (継承元 Control)
ValidatorTextStyle	Login コントロールによって使用される検証コントロールに関連付けられたエラーメッセージの外観を定義するStyleプロパティのコレクションへの参照を取得します。
ViewState	同じページに対する複数の要求にわたってサーバーコントロールのビューステートを保存および復元できる状態情報のディクショナリを取得します。 (継承元 Control)
ViewStateIgnoresCase	StateBag オブジェクトで大文字と小文字が区別されないかどうかを示す値を取得します。 (継承元 Control)
ViewStateMode	このコントロールのビューステートモードを取得または設定します。 (継承元 Control)
Visible	サーバーコントロールがページ上の UI としてレンダリングされるかどうかを示す値を取得または設定します。 (継承元 Control)
VisibleWhenLoggedIn	ユーザーの認証後に Login コントロールを表示するかどうかを示す値を取得または設定します。
Width	Web サーバーコントロールの幅を取得または設定します。 (継承元 WebControl)

メソッド

名前	説明
AddAttributesToRender(HtmlTextWriter)	指定した HtmlTextWriterTagにレンダリングする必要がある HTML 属性とスタイルを追加します。このメソッドは、主にコントロール開発者によって使用されます。 (継承元 WebControl)
AddedControl(Control, Int32)	子コントロールがControl オブジェクトのControls コレクションに追加された後に呼び出されます。 (継承元 Control)
AddParsedSubObject(Object)	XML または HTML のいずれかの要素が解析されたことをサーバーコントロールに通知し、その要素をサーバーコントロールの ControlCollection オブジェクトに追加します。 (継承元 Control)
ApplyStyle(Style)	指定したスタイルの空白以外の要素を Web コントロールにコピーし、コントロールの既存のスタイル要素を上書きします。このメソッドは、主にコントロール開発者によって使用されます。 (継承元 WebControl)
ApplyStyleSheetSkin(Page)	ページスタイルシートで定義されているスタイルプロパティをコントロールに適用します。 (継承元 Control)
BeginRenderTracing(TextWriter, Object)	レンダリングデータのデザイン時トレースを開始します。 (継承元 Control)
BuildProfileTree(String, Boolean)	サーバーコントロールに関する情報を収集し、ページのトレースが有効になっているときに表示される Trace プロパティに渡します。 (継承元 Control)
ClearCachedClientID()	キャッシュされた ClientID 値を `null`に設定します。 (継承元 Control)
ClearChildControlState()	サーバーコントロールの子コントロールのコントロール状態情報を削除します。 (継承元 Control)
ClearChildState()	すべてのサーバーコントロールの子コントロールのビューステート情報とコントロール状態情報を削除します。 (継承元 Control)
ClearChildViewState()	すべてのサーバーコントロールの子コントロールのビューステート情報を削除します。 (継承元 Control)
ClearEffectiveClientIDMode()	現在のコントロールインスタンスと子コントロールの ClientIDMode プロパティを Inheritに設定します。 (継承元 Control)
CopyBaseAttributes(WebControl)	Style オブジェクトによってカプセル化されていないプロパティを、指定した Web サーバーコントロールから、このメソッドが呼び出される Web サーバーコントロールにコピーします。このメソッドは、主にコントロール開発者によって使用されます。 (継承元 WebControl)
CreateChildControls()	Login コントロールを構成し、イベントハンドラーをイベントに関連付ける個々のコントロールを作成します。
CreateControlCollection()	サーバーコントロールの子コントロール (リテラルとサーバーの両方) を保持する新しい ControlCollection オブジェクトを作成します。 (継承元 Control)
CreateControlStyle()	すべてのスタイル関連プロパティを実装するために、 WebControl クラスによって内部的に使用されるスタイルオブジェクトを作成します。このメソッドは、主にコントロール開発者によって使用されます。 (継承元 WebControl)
DataBind()	データソースを CompositeControl とそのすべての子コントロールにバインドします。 (継承元 CompositeControl)
DataBind(Boolean)	DataBinding イベントを発生させるオプションを使用して、呼び出されたサーバーコントロールとそのすべての子コントロールにデータソースをバインドします。 (継承元 Control)
DataBindChildren()	データソースをサーバーコントロールの子コントロールにバインドします。 (継承元 Control)
Dispose()	サーバーコントロールがメモリから解放される前に、最終的なクリーンアップを実行できるようにします。 (継承元 Control)
EndRenderTracing(TextWriter, Object)	レンダリングデータのデザイン時トレースを終了します。 (継承元 Control)
EnsureChildControls()	サーバーコントロールに子コントロールが含まれているかどうかを判断します。そうでない場合は、子コントロールが作成されます。 (継承元 Control)
EnsureID()	識別子が割り当てられないコントロールの識別子を作成します。 (継承元 Control)
Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
FindControl(String, Int32)	`pathOffset` パラメーターで指定された、指定した`id`と整数を持つサーバーコントロールの現在の名前付けコンテナーを検索します。これは、検索に役立ちます。このバージョンの FindControl メソッドはオーバーライドしないでください。 (継承元 Control)
FindControl(String)	指定した `id` パラメーターを使用して、サーバーコントロールの現在の名前付けコンテナーを検索します。 (継承元 Control)
Focus()	入力フォーカスをコントロールに設定します。 (継承元 Control)
GetDesignModeState()	コントロールのデザイン時データを取得します。 (継承元 Control)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetRouteUrl(Object)	ルートパラメーターのセットに対応する URL を取得します。 (継承元 Control)
GetRouteUrl(RouteValueDictionary)	ルートパラメーターのセットに対応する URL を取得します。 (継承元 Control)
GetRouteUrl(String, Object)	ルートパラメーターとルート名のセットに対応する URL を取得します。 (継承元 Control)
GetRouteUrl(String, RouteValueDictionary)	ルートパラメーターとルート名のセットに対応する URL を取得します。 (継承元 Control)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetUniqueIDRelativeTo(Control)	指定したコントロールの UniqueID プロパティのプレフィックス部分を返します。 (継承元 Control)
HasControls()	サーバーコントロールに子コントロールが含まれているかどうかを判断します。 (継承元 Control)
HasEvents()	コントロールまたは子コントロールのイベントが登録されているかどうかを示す値を返します。 (継承元 Control)
IsLiteralContent()	サーバーコントロールがリテラルコンテンツのみを保持するかどうかを決定します。 (継承元 Control)
LoadControlState(Object)	SaveControlState() メソッドによって保存された前のページ要求から制御状態情報を復元します。 (継承元 Control)
LoadViewState(Object)	SaveViewState() メソッドで保存された以前の要求からビューステート情報を復元します。
MapPathSecure(String)	仮想パス (絶対パスまたは相対パス) がマップされる物理パスを取得します。 (継承元 Control)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
MergeStyle(Style)	指定したスタイルの空白以外の要素を Web コントロールにコピーしますが、コントロールの既存のスタイル要素は上書きしません。このメソッドは、主にコントロール開発者によって使用されます。 (継承元 WebControl)
OnAuthenticate(AuthenticateEventArgs)	Authenticate イベントを発生させ、ユーザーを認証します。
OnBubbleEvent(Object, EventArgs)	ページのユーザーインターフェイス (UI) サーバーコントロール階層にイベントを渡すかどうかを決定します。
OnDataBinding(EventArgs)	DataBinding イベントを発生させます。 (継承元 Control)
OnInit(EventArgs)	Init イベントを発生させます。 (継承元 Control)
OnLoad(EventArgs)	Load イベントを発生させます。 (継承元 Control)
OnLoggedIn(EventArgs)	ユーザーが Web サイトにログインし、認証された後に、 LoggedIn イベントを発生させます。
OnLoggingIn(LoginCancelEventArgs)	ユーザーがログイン情報を送信したときに、認証が行われる前に、 LoggingIn イベントを発生させます。
OnLoginError(EventArgs)	ログイン試行が失敗したときに、 LoginError イベントを発生させます。
OnPreRender(EventArgs)	基本 OnPreRender(EventArgs) メソッドを実装します。
OnUnload(EventArgs)	Unload イベントを発生させます。 (継承元 Control)
OpenFile(String)	ファイルの読み取りに使用する Stream を取得します。 (継承元 Control)
RaiseBubbleEvent(Object, EventArgs)	イベントのソースとその情報をコントロールの親に割り当てます。 (継承元 Control)
RecreateChildControls()	CompositeControlから派生したコントロール内の子コントロールを再作成します。 (継承元 CompositeControl)
RemovedControl(Control)	Control オブジェクトのControls コレクションから子コントロールが削除された後に呼び出されます。 (継承元 Control)
Render(HtmlTextWriter)	指定した HTML ライターを使用してログインフォームをレンダリングします。
RenderBeginTag(HtmlTextWriter)	コントロールの HTML 開始タグを指定されたライターにレンダリングします。このメソッドは、主にコントロール開発者によって使用されます。 (継承元 WebControl)
RenderChildren(HtmlTextWriter)	指定した HtmlTextWriter オブジェクトにサーバーコントロールの子のコンテンツを出力します。このオブジェクトは、クライアントにレンダリングされるコンテンツを書き込みます。 (継承元 Control)
RenderContents(HtmlTextWriter)	コントロールの内容を指定したライターにレンダリングします。このメソッドは、主にコントロール開発者によって使用されます。 (継承元 WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)	指定されたControlAdapter オブジェクトを使用して、指定されたHtmlTextWriter オブジェクトにサーバーコントロールのコンテンツを出力します。 (継承元 Control)
RenderControl(HtmlTextWriter)	指定された HtmlTextWriter オブジェクトにサーバーコントロールの内容を出力し、トレースが有効になっている場合は、コントロールに関するトレース情報を格納します。 (継承元 Control)
RenderEndTag(HtmlTextWriter)	コントロールの HTML 終了タグを指定されたライターにレンダリングします。このメソッドは、主にコントロール開発者によって使用されます。 (継承元 WebControl)
ResolveAdapter()	指定したコントロールのレンダリングを担当するコントロールアダプターを取得します。 (継承元 Control)
ResolveClientUrl(String)	ブラウザーで使用できる URL を取得します。 (継承元 Control)
ResolveUrl(String)	URL を、要求側クライアントで使用できる URL に変換します。 (継承元 Control)
SaveControlState()	ページがサーバーにポストバックされた時刻以降に発生したすべてのサーバー制御状態の変更を保存します。 (継承元 Control)
SaveViewState()	TrackViewState() メソッドが呼び出された後に変更されたすべての状態を保存します。
SetDesignModeState(IDictionary)	コントロールのデザイン時データを設定します。
SetRenderMethodDelegate(RenderMethod)	サーバーコントロールとそのコンテンツを親コントロールにレンダリングするイベントハンドラーデリゲートを割り当てます。 (継承元 Control)
SetTraceData(Object, Object, Object)	トレースオブジェクト、トレースデータキー、およびトレースデータ値を使用して、レンダリングデータのデザイン時トレース用のトレースデータを設定します。 (継承元 Control)
SetTraceData(Object, Object)	トレースデータキーとトレースデータ値を使用して、レンダリングデータのデザイン時トレース用のトレースデータを設定します。 (継承元 Control)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
TrackViewState()	基本 TrackViewState() メソッドをオーバーライドします。

イベント

名前	説明
Authenticate	ユーザーが認証されたときに発生します。
DataBinding	サーバーコントロールがデータソースにバインドされるときに発生します。 (継承元 Control)
Disposed	サーバーコントロールがメモリから解放されたときに発生します。これは、ASP.NET ページが要求されたときに、サーバーコントロールライフサイクルの最後のステージです。 (継承元 Control)
Init	サーバーコントロールが初期化されるときに発生します。これは、そのライフサイクルの最初のステップです。 (継承元 Control)
Load	サーバーコントロールが Page オブジェクトに読み込まれるときに発生します。 (継承元 Control)
LoggedIn	ユーザーが Web サイトにログインし、認証されたときに発生します。
LoggingIn	認証が行われる前に、ユーザーがログイン情報を送信したときに発生します。
LoginError	ログインエラーが検出されたときに発生します。
PreRender	Control オブジェクトが読み込まれた後、レンダリングの前に発生します。 (継承元 Control)
Unload	サーバーコントロールがメモリからアンロードされるときに発生します。 (継承元 Control)

明示的なインターフェイスの実装

名前	説明
IAttributeAccessor.GetAttribute(String)	指定した名前の Web コントロールの属性を取得します。 (継承元 WebControl)
IAttributeAccessor.SetAttribute(String, String)	Web コントロールの属性を指定した名前と値に設定します。 (継承元 WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	デザイナーがデザイン時環境で複合コントロールの子コントロールのコレクションを再作成できるようにします。 (継承元 CompositeControl)
IControlBuilderAccessor.ControlBuilder	このメンバーの説明については、 ControlBuilderを参照してください。 (継承元 Control)
IControlDesignerAccessor.GetDesignModeState()	このメンバーの説明については、 GetDesignModeState()を参照してください。 (継承元 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	このメンバーの説明については、 SetDesignModeState(IDictionary)を参照してください。 (継承元 Control)
IControlDesignerAccessor.SetOwnerControl(Control)	このメンバーの説明については、 SetOwnerControl(Control)を参照してください。 (継承元 Control)
IControlDesignerAccessor.UserData	このメンバーの説明については、 UserDataを参照してください。 (継承元 Control)
IDataBindingsAccessor.DataBindings	このメンバーの説明については、 DataBindingsを参照してください。 (継承元 Control)
IDataBindingsAccessor.HasDataBindings	このメンバーの説明については、 HasDataBindingsを参照してください。 (継承元 Control)
IExpressionsAccessor.Expressions	このメンバーの説明については、 Expressionsを参照してください。 (継承元 Control)
IExpressionsAccessor.HasExpressions	このメンバーの説明については、 HasExpressionsを参照してください。 (継承元 Control)
IParserAccessor.AddParsedSubObject(Object)	このメンバーの説明については、 AddParsedSubObject(Object)を参照してください。 (継承元 Control)

拡張メソッド

名前	説明
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	指定したデータコントロールの動的データ動作を有効にします。
EnableDynamicData(INamingContainer, Type, Object)	指定したデータコントロールの動的データ動作を有効にします。
EnableDynamicData(INamingContainer, Type)	指定したデータコントロールの動的データ動作を有効にします。
FindDataSourceControl(Control)	指定したコントロールのデータコントロールに関連付けられているデータソースを返します。
FindFieldTemplate(Control, String)	指定したコントロールの名前付けコンテナー内の指定した列のフィールドテンプレートを返します。
FindMetaTable(Control)	格納されているデータコントロールのメタテーブルオブジェクトを返します。
GetDefaultValues(INamingContainer)	指定したデータコントロールの既定値のコレクションを取得します。
GetMetaTable(INamingContainer)	指定したデータコントロールのテーブルメタデータを取得します。
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	指定したデータコントロールのテーブルメタデータと既定値のマッピングを設定します。
SetMetaTable(INamingContainer, MetaTable, Object)	指定したデータコントロールのテーブルメタデータと既定値のマッピングを設定します。
SetMetaTable(INamingContainer, MetaTable)	指定したデータコントロールのテーブルメタデータを設定します。
TryGetMetaTable(INamingContainer, MetaTable)	テーブルメタデータを使用できるかどうかを判断します。

適用対象

こちらもご覧ください

フィードバック

このページはお役に立ちましたか?