Login Класс

Определение

Предоставляет элементы пользовательского интерфейса для записи на веб-сайт.

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
Наследование
Атрибуты

Примеры

В следующем примере кода используется Login элемент управления для предоставления пользовательского интерфейса для входа на веб-сайт.

<%@ 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 элемента управления.

Важно!

Этот пример содержит текстовое поле, которое принимает вводимые пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и 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

Комментарии

В этом разделе:

Вступление

LoginЭлемент управления является составным элементом управления, предоставляющим все общие элементы пользовательского интерфейса, необходимые для проверки подлинности пользователя на веб-сайте. Для всех сценариев входа требуются следующие три элемента:

  • Уникальное имя пользователя, идентифицирующее пользователя.

  • Пароль для проверки удостоверения пользователя.

  • Кнопка входа для отправки сведений об имени входа на сервер.

LoginЭлемент управления также предоставляет следующие необязательные элементы пользовательского интерфейса, поддерживающие дополнительные функции:

  • Ссылка на напоминание о пароле.

  • Флажок "Запомнить мои данные", чтобы сохранить сведения об имени входа между сеансами.

  • Ссылка на справку для пользователей, у которых возникают проблемы при входе в систему.

  • Ссылка Регистрация нового пользователя, которая перенаправляет пользователей на страницу регистрации.

  • Текст инструкции, отображаемый в форме входа.

  • Пользовательский текст ошибки, отображаемый при нажатии пользователем кнопки входа без заполнения полей имя пользователя или пароль.

  • Пользовательский текст ошибки, отображаемый при сбое входа.

  • Настраиваемое действие, выполняемое при завершении входа.

  • Способ скрытия элемента управления для входа, если пользователь уже вошел на сайт.

Таблицу, показывающую, какие элементы управления являются обязательными, а какие — необязательными, см. в разделе LayoutTemplate свойство.

Примечание

если вы не знакомы с набором элементов управления входа, доступных в ASP.NET, см. раздел общие сведения об элементах управления входом ASP.NET , прежде чем продолжить. Список других разделов, связанных с элементами управления входом и членством, см. в разделе Управление пользователями с помощью членства.

Важно!

Принятие пользовательского ввода является потенциальной угрозой безопасности. Пользователи-злоумышленники могут передавать данные, предназначенные для предоставления уязвимостей или запуска программ, которые используют созданные пароли. Чтобы повысить безопасность при работе с вводом данных пользователем, следует использовать функции проверки элемента управления и защитить все поставщики данных, настроенные для вашего элемента управления. Дополнительные сведения см. в статьях Защита элементов управления входом, основные методы обеспечения безопасности для веб-приложенийи Защита членства.

LoginЭлемент управления использует поставщик членства для получения учетных данных пользователя. Если не указано иное, Login элемент управления использует поставщик членства по умолчанию, определенный в файле Web.config. Чтобы указать другого поставщика, задайте MembershipProvider для свойства одно из имен поставщиков членства, определенных в файле Web.config приложения. Дополнительные сведения см. в разделе поставщики членства.

Если вы хотите использовать пользовательскую службу проверки подлинности, можно использовать OnAuthenticate метод для вызова службы.

Стили и шаблоны

Внешний вид Login элемента управления полностью настраиваем через шаблоны и параметры стиля. Все текстовые сообщения пользовательского интерфейса также можно настраивать с помощью свойств Login класса. Текст интерфейса по умолчанию автоматически локализуется на основе параметра языкового стандарта на сервере.

Если Login элемент управления настроен с помощью шаблонов, AccessKey свойство и TabIndex свойство игнорируются. В этом случае задайте AccessKey свойство и TabIndex свойство для каждого дочернего элемента шаблона напрямую.

Login свойства элементов управления, представленные текстовыми полями, например UserName и, доступны на Password всех этапах жизненного цикла страницы. Элемент управления выберет все изменения, внесенные конечным пользователем, с помощью TextChanged события, запускаемого из текстовых полей.

Примечание

При внедрении Login элемента управления в WizardStep объект явно задавайте ActiveStepIndex свойство в Page_Load обработчике событий, если пользователь прошел проверку подлинности. WizardЭлемент управления не переходит автоматически к следующему WizardStep объекту в этом сценарии.

В следующей таблице перечислены Login свойства стиля элемента управления и объясняется, какой элемент пользовательского интерфейса влияет на каждое свойство стиля. Список свойств, к которым применяется каждый стиль, см. в документации по отдельным свойствам стиля.

Свойство Style Затронутый элемент пользовательского интерфейса
BorderPadding Пространство между содержимым элемента управления и его границей.
CheckBoxStyle Флажок "Запомнить мои".
FailureTextStyle Текст ошибки входа.
InstructionTextStyle Пояснительный текст на странице, который указывает пользователям, как использовать элемент управления.
LabelStyle Метки для всех полей ввода, например текстовых полей.
TextBoxStyle Поля ввода текста.
TitleTextStyle Текст заголовка.
ValidatorTextStyle Текст, отображаемый пользователю при неудачной попытке входа из-за ошибок проверки.
HyperLinkStyle Ссылки на другие страницы.
LoginButtonStyle Кнопка входа.

Группы проверки

UserNameСвойства и Password имеют RequiredFieldValidator связанные с ними элементы управления, чтобы запретить пользователям отправку страницы без предоставления необходимой информации.

LoginЭлемент управления использует группу проверки, чтобы другие поля на той же странице, что и Login элемент управления, можно было проверять отдельно. По умолчанию ID свойство Login элемента управления используется в качестве имени группы проверки. Например, Login элемент управления с идентификатором "Login1" будет использовать имя группы проверки "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

Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления.

(Унаследовано от WebControl)
Adapter

Возвращает конкретный адаптер браузера для элемента управления.

(Унаследовано от Control)
AppRelativeTemplateSourceDirectory

Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления.

(Унаследовано от Control)
Attributes

Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления.

(Унаследовано от WebControl)
BackColor

Получает или задает цвет фона серверного веб-элемента управления.

(Унаследовано от WebControl)
BindingContainer

Возвращает элемент управления, который содержит привязку данных элемента управления.

(Унаследовано от Control)
BorderColor

Возвращает или задает цвет рамки элемента управления Веба.

(Унаследовано от WebControl)
BorderPadding

Возвращает или задает размер поля в пределах границ элемента управления Login.

BorderStyle

Получает или задает стиль границы серверного веб-элемента управления.

(Унаследовано от WebControl)
BorderWidth

Возвращает или задает ширину границы серверного веб-элемента управления.

(Унаследовано от WebControl)
CheckBoxStyle

Возвращает ссылку на объект Style, определяющий параметры флажка "Запомнить мои данные".

ChildControlsCreated

Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления.

(Унаследовано от Control)
ClientID

Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET.

(Унаследовано от Control)
ClientIDMode

Возвращает или задает алгоритм, используемый для создания значения свойства ClientID.

(Унаследовано от Control)
ClientIDSeparator

Возвращает значение символа разделителя, используемого в свойстве ClientID.

(Унаследовано от Control)
Context

Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса.

(Унаследовано от Control)
Controls

Возвращает объект ControlCollection, содержащий дочерние элементы CompositeControl.

(Унаследовано от CompositeControl)
ControlStyle

Возвращает или задает стиль серверного веб-элемента управления. Это свойство используется преимущественно разработчиками элементов управления.

(Унаследовано от WebControl)
ControlStyleCreated

Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle. Этот свойство в основном используется разработчиками элементов управления.

(Унаследовано от WebControl)
CreateUserIconUrl

Получает расположение изображения, которое будет отображаться рядом со ссылкой на страницу регистрации новых пользователей.

CreateUserText

Получает или задает текст ссылки на страницу регистрации новых пользователей.

CreateUserUrl

Получает или задает URL-адрес новой страницы регистрации пользователей.

CssClass

Возвращает или задает класс каскадных листов стилей (CSS), преобразовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере.

(Унаследовано от WebControl)
DataItemContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataItemContainer.

(Унаследовано от Control)
DataKeysContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataKeysControl.

(Унаследовано от Control)
DesignMode

Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки.

(Унаследовано от Control)
DestinationPageUrl

Получает или задает URL-адрес страницы, отображаемой для пользователя при удачной попытке входа.

DisplayRememberMe

Получает или задает значение, указывающее, нужно ли выводить флажок, позволяющий пользователю управлять возможность отправки постоянного файла Cookie в его браузер.

Enabled

Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления.

(Унаследовано от WebControl)
EnableTheming

Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления.

(Унаследовано от WebControl)
EnableViewState

Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления.

(Унаследовано от Control)
Events

Возвращает список делегатов обработчиков событий элемента управления. Это свойство доступно только для чтения.

(Унаследовано от Control)
FailureAction

Получает или задает действие, которое происходит в случае неудачной попытки входа.

FailureText

Получает или задает текст, отображаемый в случае неудачной попытки входа.

FailureTextStyle

Получает ссылку на коллекцию свойств, которые определяют внешний вид текста сообщений об ошибке в элементе управления Login.

Font

Возвращает свойства шрифта, связанные с серверным веб-элементом управления.

(Унаследовано от WebControl)
ForeColor

Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления.

(Унаследовано от WebControl)
HasAttributes

Получает значение, определяющие наличие атрибутов у элемента управления.

(Унаследовано от WebControl)
HasChildViewState

Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления.

(Унаследовано от Control)
Height

Получает или задает высоту серверного веб-элемента управления.

(Унаследовано от WebControl)
HelpPageIconUrl

Получает расположение изображения, которое отображается рядом со ссылкой на страницу справки при входе.

HelpPageText

Получает или задает текст ссылки на страницу справки по выполнению входа.

HelpPageUrl

Получает или задает URL-адрес страницы справки по выполнению входа.

HyperLinkStyle

Возвращает ссылку на коллекцию свойств, которые определяют внешний вид гиперссылок в элементе управления Login.

ID

Возвращает или задает программный идентификатор, назначенный серверному элементу управления.

(Унаследовано от Control)
IdSeparator

Возвращает символ, используемый для разделения идентификаторов элементов управления.

(Унаследовано от Control)
InstructionText

Получает или задает текст инструкций по выполнению входа для пользователя.

InstructionTextStyle

Получает ссылку на объект TableItemStyle, определяющий параметры текста инструкций в элементе управления Login.

IsChildControlStateCleared

Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления.

(Унаследовано от Control)
IsEnabled

Возвращает значение, определяющее, включен ли элемент управления.

(Унаследовано от WebControl)
IsTrackingViewState

Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления.

(Унаследовано от Control)
IsViewStateEnabled

Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления.

(Унаследовано от Control)
LabelStyle

Получает ссылку на объект TableItemStyle, определяющий параметры сигнатур к элементу управления Login.

LayoutTemplate

Получает или задает шаблон, используемый для отображения элемента управления Login.

LoadViewStateByID

Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса.

(Унаследовано от Control)
LoginButtonImageUrl

Получает или задает URL-адрес изображения, используемого для кнопки входа.

LoginButtonStyle

Получает ссылку на объект Style, позволяющий задать внешний вид кнопки входа в элементе управления Login.

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

Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML.

(Унаследовано от Control)
RenderOuterTable

Получает или задает значение, определяющее, заключает ли элемент управления отображаемый HTML-код в элемент table для применения встроенных стилей.

Site

Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора.

(Унаследовано от Control)
SkinID

Возвращает или задает обложку, применяемую к элементу управления.

(Унаследовано от WebControl)
Style

Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления.

(Унаследовано от WebControl)
SupportsDisabledAttribute

Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута disabled отрисовываемого элемента HTML значение disabled, если для свойства элемента управления IsEnabled задано значение false.

(Унаследовано от CompositeControl)
TabIndex

Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления.

(Унаследовано от WebControl)
TagKey

Получает значение HtmlTextWriterTag, соответствующее элементу управления Login. Это свойство используется преимущественно разработчиками элементов управления.

TagName

Возвращает имя тега элемента управления. Это свойство используется преимущественно разработчиками элементов управления.

(Унаследовано от WebControl)
TemplateControl

Возвращает или задает ссылку на шаблон, содержащий этот элемент управления.

(Унаследовано от Control)
TemplateSourceDirectory

Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления.

(Унаследовано от Control)
TextBoxStyle

Получает ссылку на коллекцию свойств, которые определяют внешний вид текстовых полей в элементе управления Login.

TextLayout

Задает расположение каждой подписи по отношению к соответствующему текстовому полю для элемента управления Login.

TitleText

Получает или задает заголовок элемента управления Login.

TitleTextStyle

Получает ссылку на коллекцию свойств, которые определяют внешний вид текста заголовка в элементе управления Login.

ToolTip

Возвращает или задает текст, который отображается при наведении указателя мыши на серверный веб-элемент управления.

(Унаследовано от WebControl)
UniqueID

Возвращает уникальный идентификатор серверного элемента управления в иерархии.

(Унаследовано от Control)
UserName

Получает имя пользователя, введенное пользователем.

UserNameLabelText

Возвращает или задает текст подписи для текстового поля UserName.

UserNameRequiredErrorMessage

Получает или задает сообщение об ошибке, отображаемое в элементе управления ValidationSummary, если поле имени пользователя осталось незаполненным.

ValidateRequestMode

Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений.

(Унаследовано от Control)
ValidatorTextStyle

Возвращает ссылку на коллекцию свойств Style, которые определяют внешний вид сообщений об ошибке, связанных проверяющими элементами управления, которые используются элементом управления Login.

ViewState

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы.

(Унаследовано от Control)
ViewStateIgnoresCase

Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру.

(Унаследовано от Control)
ViewStateMode

Возвращает или задает режим состояния представления данного элемента управления.

(Унаследовано от Control)
Visible

Получает или задает значение, указывающее, отрисовывается ли серверный элемент управления как пользовательский интерфейс на странице.

(Унаследовано от Control)
VisibleWhenLoggedIn

Получает или задает значение, позволяющее определить, будет ли отображаться элемент управления Login после прохождения пользователем проверки подлинности.

Width

Получает или задает ширину серверного веб-элемента управления.

(Унаследовано от WebControl)

Методы

AddAttributesToRender(HtmlTextWriter)

Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном элементе управления HtmlTextWriterTag. Этот метод используется в основном разработчиками элементов управления.

(Унаследовано от WebControl)
AddedControl(Control, Int32)

Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control.

(Унаследовано от Control)
AddParsedSubObject(Object)

Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection.

(Унаследовано от Control)
ApplyStyle(Style)

Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля. Этот метод, в основном, используется разработчиками элементов управления.

(Унаследовано от 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 свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод. Этот метод используется в основном разработчиками элементов управления.

(Унаследовано от 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)

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.

(Унаследовано от Control)
FindControl(String, Int32)

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску. Эту версию метода FindControl не следует переопределять.

(Унаследовано от 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)

Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля. Этот метод используется в основном разработчиками элементов управления.

(Унаследовано от WebControl)
OnAuthenticate(AuthenticateEventArgs)

Вызывает событие Authenticate для проверки подлинности пользователя.

OnBubbleEvent(Object, EventArgs)

Определяет, нужно ли передать событие вверх по иерархии серверных элементов управления пользовательского интерфейса данной страницы.

OnDataBinding(EventArgs)

Вызывает событие DataBinding.

(Унаследовано от Control)
OnInit(EventArgs)

Вызывает событие Init.

(Унаследовано от Control)
OnLoad(EventArgs)

Вызывает событие Load.

(Унаследовано от Control)
OnLoggedIn(EventArgs)

Вызывает событие 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)

Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control.

(Унаследовано от Control)
Render(HtmlTextWriter)

Отображает форму входа с помощью указанного модуля записи HTML.

RenderBeginTag(HtmlTextWriter)

Выводит открывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления.

(Унаследовано от WebControl)
RenderChildren(HtmlTextWriter)

Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте.

(Унаследовано от Control)
RenderContents(HtmlTextWriter)

Выводит содержимое элемента управления в заданный модуль записи. Этот метод используется в основном разработчиками элементов управления.

(Унаследовано от WebControl)
RenderControl(HtmlTextWriter)

Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена.

(Унаследовано от Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter.

(Унаследовано от Control)
RenderEndTag(HtmlTextWriter)

Отображает закрывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления.

(Унаследовано от WebControl)
ResolveAdapter()

Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления.

(Унаследовано от Control)
ResolveClientUrl(String)

Возвращает URL-адрес, который может использоваться браузером.

(Унаследовано от Control)
ResolveUrl(String)

Преобразует URL-адрес в адрес, доступный для клиента.

(Унаследовано от Control)
SaveControlState()

Сохраняет любые изменения состояния серверного элемента управления, произошедшие после отправки страницы обратно на сервер.

(Унаследовано от Control)
SaveViewState()

Сохраняет любое состояние, которое было изменено после вызова метода TrackViewState().

SetDesignModeState(IDictionary)

Задает данные времени разработки для элемента управления.

SetRenderMethodDelegate(RenderMethod)

Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления.

(Унаследовано от Control)
SetTraceData(Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки.

(Унаследовано от Control)
SetTraceData(Object, Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки.

(Унаследовано от Control)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
TrackViewState()

Переопределяет базовый метод TrackViewState().

События

Authenticate

Происходит после прохождения пользователем проверки подлинности.

DataBinding

Происходит при привязке серверного элемента управления к источнику данных.

(Унаследовано от Control)
Disposed

Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET.

(Унаследовано от Control)
Init

Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла.

(Унаследовано от Control)
Load

Происходит при загрузке серверного элемента управления в объект Page.

(Унаследовано от Control)
LoggedIn

Происходит после входа пользователя на веб-узел и прохождения им проверки подлинности.

LoggingIn

Происходит при передаче пользователем данных для входа до того, как будет выполнена проверка подлинности.

LoginError

Происходит при обнаружении ошибки входа.

PreRender

Происходит после загрузки объекта Control, но перед отрисовкой.

(Унаследовано от Control)
Unload

Происходит при выгрузке серверного элемента управления из памяти.

(Унаследовано от Control)

Явные реализации интерфейса

IAttributeAccessor.GetAttribute(String)

Возвращает атрибуту веб-элемента управления указанное имя.

(Унаследовано от WebControl)
IAttributeAccessor.SetAttribute(String, String)

Задает атрибуту веб-элемента управления указанное имя и значение.

(Унаследовано от 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)

Методы расширения

FindDataSourceControl(Control)

Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления.

FindFieldTemplate(Control, String)

Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления.

FindMetaTable(Control)

Возвращает объект метатаблицы для контейнерного элемента управления данными.

GetDefaultValues(INamingContainer)

Получает коллекцию значений по умолчанию для заданного элемента управления данными.

GetMetaTable(INamingContainer)

Получает метаданные таблицы для заданного элемента управления данными.

SetMetaTable(INamingContainer, MetaTable)

Задает метаданные таблицы для заданного элемента управления данными.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.

SetMetaTable(INamingContainer, MetaTable, Object)

Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.

TryGetMetaTable(INamingContainer, MetaTable)

Определяет, доступны ли метаданные таблицы.

EnableDynamicData(INamingContainer, Type)

Включает поведение платформы динамических данных для указанного элемента управления данными.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Включает поведение платформы динамических данных для указанного элемента управления данными.

EnableDynamicData(INamingContainer, Type, Object)

Включает поведение платформы динамических данных для указанного элемента управления данными.

Применяется к

См. также раздел