Login Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece elementos de interface do usuário para fazer logon em um site.
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 CompositeControlPublic Class Login
Inherits CompositeControl- Herança
- Atributos
Exemplos
O exemplo de código a seguir usa um Login controle para fornecer uma interface do usuário para fazer logon em um site.
<%@ 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>
O exemplo de código a seguir demonstra como você pode estender o Login controle. O CustomLogin controle inclui um DropDownList controle que permite que os usuários escolham com qual provedor de associação eles são autenticados. (Esses provedores são configurados no Web.config.) OnLoggingIn No método, a MembershipProvider propriedade é definida como o valor selecionado do DropDownList controle.
Importante
Este exemplo contém uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos de script ou HTML. Para obter mais informações, consulte Visão geral das Explorações de Script.
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
Comentários
Neste tópico:
Introdução
O Login controle é um controle composto que fornece todos os elementos comuns da interface do usuário necessários para autenticar um usuário em um site da Web. Os três elementos a seguir são necessários para todos os cenários de logon:
Um nome de usuário exclusivo para identificar o usuário.
Uma senha para verificar a identidade do usuário.
Um botão de logon para enviar as informações de logon para o servidor.
O Login controle também fornece os seguintes elementos opcionais de interface do usuário que dão suporte a funções adicionais:
Um link para um lembrete de senha.
Uma caixa de seleção Remember Me para manter as informações de logon entre as sessões.
Um link de Ajuda para usuários que estão tendo problemas para fazer logon.
Um link Registrar Novo Usuário que redireciona os usuários para uma página de registro.
Texto da instrução que aparece no formulário de logon.
Texto de erro personalizado que aparece quando o usuário clica no botão de logon sem preencher os campos de nome de usuário ou senha.
Texto de erro personalizado exibido se o logon falhar.
Uma ação personalizada que ocorre quando o logon é bem-sucedido.
Uma maneira de ocultar o controle de logon se o usuário já estiver conectado ao site.
Para uma tabela que mostra quais controles são necessários e quais são opcionais, consulte LayoutTemplate a propriedade.
Observação
Se você não estiver familiarizado com o conjunto de controles de logon disponível no ASP.NET, consulte ASP.NET Visão geral dos controles de logon antes de continuar. Para obter uma lista de outros tópicos relacionados a controles de logon e associação, consulte Gerenciando usuários usando associação.
Importante
Aceitar a entrada do usuário é uma ameaça à segurança em potencial. Usuários mal-intencionados podem enviar dados destinados a expor vulnerabilidades ou executar programas que tentam senhas geradas. Para melhorar a segurança ao trabalhar com a entrada do usuário, você deve usar os recursos de validação do controle e proteger todos os provedores de dados configurados para o controle. Para obter mais informações, consulte Proteção de controles de logon, práticas básicas de segurança para aplicativos Web e proteção da associação.
O Login controle usa um provedor de associação para obter credenciais de usuário. A menos que você especifique o contrário, o Login controle usa o provedor de associação padrão definido no arquivo Web.config. Para especificar um provedor diferente, defina a MembershipProvider propriedade como um dos nomes de provedor de associação definidos no arquivo Web.config do aplicativo. Para obter mais informações, consulte Provedores de Associação.
Se você quiser usar um serviço de autenticação personalizado, poderá usar o OnAuthenticate método para chamar o serviço.
Estilos e modelos
A aparência do Login controle é totalmente personalizável por meio de modelos e configurações de estilo. Todas as mensagens de texto da interface do usuário também são personalizáveis por meio de propriedades da Login classe. O texto da interface padrão é localizado automaticamente com base na configuração de localidade no servidor.
Se o Login controle for personalizado com modelos, a AccessKey propriedade e a TabIndex propriedade serão ignoradas. Nesse caso, defina a AccessKey propriedade e a TabIndex propriedade de cada controle filho de modelo diretamente.
Login as propriedades de controle representadas por caixas de texto, como UserName e Password, são acessíveis durante todas as fases do ciclo de vida da página. O controle selecionará todas as alterações feitas pelo usuário final por meio do TextChanged evento disparado pelas caixas de texto.
Observação
Se você inserir o Login controle em um WizardStep objeto, defina explicitamente a ActiveStepIndex propriedade em um Page_Load manipulador de eventos se o usuário estiver autenticado. O Wizard controle não avança automaticamente para o próximo WizardStep objeto neste cenário.
A tabela a seguir lista as Login propriedades de estilo de controle e explica qual elemento de interface do usuário cada propriedade de estilo afeta. Para obter uma lista de quais propriedades cada estilo se aplica, consulte a documentação das propriedades de estilo individuais.
| Propriedade Style | Elemento de interface do usuário afetado |
|---|---|
| BorderPadding | O espaço entre o conteúdo do controle e a borda do controle. |
| CheckBoxStyle | Lembre-se de mim caixa de seleção. |
| FailureTextStyle | Texto de falha de logon. |
| InstructionTextStyle | Texto instrucional na página que informa aos usuários como usar o controle. |
| LabelStyle | Rótulos para todos os campos de entrada, como caixas de texto. |
| TextBoxStyle | Campos de entrada de texto. |
| TitleTextStyle | Texto do título. |
| ValidatorTextStyle | Texto exibido para o usuário quando uma tentativa de logon não é bem-sucedida devido a erros de validação. |
| HyperLinkStyle | Links para outras páginas. |
| LoginButtonStyle | Botão De logon. |
Agrupamentos de validação
As propriedades e Password as UserName propriedades têm RequiredFieldValidator controles associados a elas para impedir que os usuários enviem a página sem fornecer informações necessárias.
O Login controle usa um grupo de validação para que outros campos na mesma página que o Login controle possam ser validados separadamente. Por padrão, a ID propriedade do Login controle é usada como o nome do grupo de validação. Por exemplo, um Login controle com a ID "Login1" usará um nome de grupo de validação de "Logon1". Se você quiser definir o grupo de validação do qual o Login controle faz parte, você deverá definir o controle e alterar o nome do grupo de validação.
Aplicando estilos CSS
O Login controle permite especificar regras de estilo CSS na marcação. Se você usar modelos para personalizar a aparência do Login controle, poderá especificar estilos CSS na marcação nos modelos. Nesse caso, nenhuma tabela externa extra é necessária. Você pode impedir que a tabela seja renderizada definindo a RenderOuterTable propriedade como false.
Accessibility
Para obter informações sobre como configurar esse controle para que ele gere marcação em conformidade com os padrões de acessibilidade, consulte Acessibilidade no Visual Studio e ASP.NET e ASP.NET Controles e Acessibilidade.
Sintaxe declarativa
<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>
Construtores
| Nome | Description |
|---|---|
| Login() |
Cria uma nova instância do Login controle. |
Campos
| Nome | Description |
|---|---|
| LoginButtonCommandName |
Representa o nome do comando associado ao botão de logon. |
Propriedades
| Nome | Description |
|---|---|
| AccessKey |
Obtém ou define a chave de acesso que permite navegar rapidamente até o controle do servidor Web. (Herdado de WebControl) |
| Adapter |
Obtém o adaptador específico do navegador para o controle. (Herdado de Control) |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo ao aplicativo do Page objeto ou UserControl que contém esse controle. (Herdado de Control) |
| Attributes |
Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades no controle. (Herdado de WebControl) |
| BackColor |
Obtém ou define a cor da tela de fundo do controle do servidor Web. (Herdado de WebControl) |
| BindingContainer |
Obtém o controle que contém a associação de dados desse controle. (Herdado de Control) |
| BorderColor |
Obtém ou define a cor da borda do controle Web. (Herdado de WebControl) |
| BorderPadding |
Obtém ou define a quantidade de preenchimento dentro das bordas do Login controle. |
| BorderStyle |
Obtém ou define o estilo de borda do controle do servidor Web. (Herdado de WebControl) |
| BorderWidth |
Obtém ou define a largura da borda do controle do servidor Web. (Herdado de WebControl) |
| CheckBoxStyle |
Obtém uma referência a um Style objeto que define as configurações da caixa de seleção Lembrar-me. |
| ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle do servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém a ID de controle para marcação HTML gerada por ASP.NET. (Herdado de Control) |
| ClientIDMode |
Obtém ou define o algoritmo usado para gerar o valor da ClientID propriedade. (Herdado de Control) |
| ClientIDSeparator |
Obtém um valor de caractere que representa o caractere separador usado na ClientID propriedade. (Herdado de Control) |
| Context |
Obtém o HttpContext objeto associado ao controle do servidor para a solicitação da Web atual. (Herdado de Control) |
| Controls |
Obtém um ControlCollection objeto que representa os controles filho em um CompositeControl. (Herdado de CompositeControl) |
| ControlStyle |
Obtém o estilo do controle do servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| ControlStyleCreated |
Obtém um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| CreateUserIconUrl |
Obtém o local de uma imagem a ser exibida ao lado do link para uma página de registro para novos usuários. |
| CreateUserText |
Obtém ou define o texto de um link para uma página de registro para novos usuários. |
| CreateUserUrl |
Obtém ou define a URL da página de registro do novo usuário. |
| CssClass |
Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente. (Herdado de WebControl) |
| DataItemContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataItemContainer. (Herdado de Control) |
| DataKeysContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataKeysControl. (Herdado de Control) |
| DesignMode |
Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control) |
| DestinationPageUrl |
Obtém ou define a URL da página exibida para o usuário quando uma tentativa de logon é bem-sucedida. |
| DisplayRememberMe |
Obtém ou define um valor que indica se uma caixa de seleção deve ser exibida para permitir que o usuário controle se um cookie persistente é enviado ao navegador. |
| Enabled |
Obtém ou define um valor que indica se o controle do servidor Web está habilitado. (Herdado de WebControl) |
| EnableTheming |
Obtém ou define um valor que indica se os temas se aplicam a esse controle. (Herdado de WebControl) |
| EnableViewState |
Obtém ou define um valor que indica se o controle do servidor persiste seu estado de exibição e o estado de exibição de todos os controles filho que ele contém, para o cliente solicitante. (Herdado de Control) |
| Events |
Obtém uma lista de representantes do manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control) |
| FailureAction |
Obtém ou define a ação que ocorre quando uma tentativa de logon falha. |
| FailureText |
Obtém ou define o texto exibido quando uma tentativa de logon falha. |
| FailureTextStyle |
Obtém uma referência a uma coleção de propriedades que definem a aparência do texto de erro no Login controle. |
| Font |
Obtém as propriedades de fonte associadas ao controle do servidor Web. (Herdado de WebControl) |
| ForeColor |
Obtém ou define a cor do primeiro plano (normalmente a cor do texto) do controle do servidor Web. (Herdado de WebControl) |
| HasAttributes |
Obtém um valor que indica se o controle tem atributos definidos. (Herdado de WebControl) |
| HasChildViewState |
Obtém um valor que indica se os controles filho do controle do servidor atual têm configurações de estado de exibição salvas. (Herdado de Control) |
| Height |
Obtém ou define a altura do controle do servidor Web. (Herdado de WebControl) |
| HelpPageIconUrl |
Obtém o local de uma imagem a ser exibida ao lado do link para a página de Ajuda de logon. |
| HelpPageText |
Obtém ou define o texto de um link para a página de Ajuda de logon. |
| HelpPageUrl |
Obtém ou define a URL da página de Ajuda de logon. |
| HyperLinkStyle |
Obtém uma referência a uma coleção de propriedades que definem a aparência de hiperlinks no Login controle. |
| ID |
Obtém ou define o identificador programático atribuído ao controle do servidor. (Herdado de Control) |
| IdSeparator |
Obtém o caractere usado para separar identificadores de controle. (Herdado de Control) |
| InstructionText |
Obtém ou define o texto de instrução de logon para o usuário. |
| InstructionTextStyle |
Obtém uma referência a um TableItemStyle objeto que define as configurações de texto de instrução no Login controle. |
| IsChildControlStateCleared |
Obtém um valor que indica se os controles contidos nesse controle têm estado de controle. (Herdado de Control) |
| IsEnabled |
Obtém um valor que indica se o controle está habilitado. (Herdado de WebControl) |
| IsTrackingViewState |
Obtém um valor que indica se o controle do servidor está salvando alterações em seu estado de exibição. (Herdado de Control) |
| IsViewStateEnabled |
Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control) |
| LabelStyle |
Obtém uma referência a um TableItemStyle objeto que define as configurações para Login rótulos de controle. |
| LayoutTemplate |
Obtém ou define o modelo usado para exibir o Login controle. |
| LoadViewStateByID |
Obtém um valor que indica se o controle participa no carregamento de seu estado de exibição ID em vez de índice. (Herdado de Control) |
| LoginButtonImageUrl |
Obtém ou define a URL de uma imagem a ser usada para o botão de logon. |
| LoginButtonStyle |
Obtém uma referência ao Style objeto que permite definir a aparência do botão de logon no Login controle. |
| LoginButtonText |
Obtém ou define o texto do Login botão de logon do controle. |
| LoginButtonType |
Obtém ou define o tipo de botão a ser usado ao renderizar o Login botão. |
| MembershipProvider |
Obtém ou define o nome do provedor de dados de associação usado pelo controle. |
| NamingContainer |
Obtém uma referência ao contêiner de nomenclatura do controle de servidor, que cria um namespace exclusivo para diferenciar entre controles de servidor com o mesmo ID valor de propriedade. (Herdado de Control) |
| Orientation |
Obtém ou define um valor que especifica a posição dos elementos do Login controle na página. |
| Page |
Obtém uma referência à Page instância que contém o controle do servidor. (Herdado de Control) |
| Parent |
Obtém uma referência ao controle pai do controle do servidor na hierarquia de controle de página. (Herdado de Control) |
| Password |
Obtém a senha inserida pelo usuário. |
| PasswordLabelText |
Obtém ou define o texto do rótulo da Password caixa de texto. |
| PasswordRecoveryIconUrl |
Obtém o local de uma imagem a ser exibida ao lado do link para a página de recuperação de senha. |
| PasswordRecoveryText |
Obtém ou define o texto de um link para a página de recuperação de senha. |
| PasswordRecoveryUrl |
Obtém ou define a URL da página de recuperação de senha. |
| PasswordRequiredErrorMessage |
Obtém ou define a mensagem de erro a ser exibida em um ValidationSummary controle quando o campo de senha é deixado em branco. |
| RememberMeSet |
Obtém ou define um valor que indica se um cookie de autenticação persistente deve ser enviado para o navegador do usuário. |
| RememberMeText |
Obtém ou define o texto do rótulo da caixa de seleção Lembrar-me. |
| RenderingCompatibility |
Obtém um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| RenderOuterTable |
Obtém ou define um valor que indica se o controle inclui HTML renderizado em um |
| Site |
Obtém informações sobre o contêiner que hospeda o controle atual quando renderizado em uma superfície de design. (Herdado de Control) |
| SkinID |
Obtém ou define a pele a ser aplicada ao controle. (Herdado de WebControl) |
| Style |
Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle do servidor Web. (Herdado de WebControl) |
| SupportsDisabledAttribute |
Obtém um valor que indica se o controle deve definir o |
| TabIndex |
Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl) |
| TagKey |
Obtém o HtmlTextWriterTag valor que corresponde a um Login controle. Essa propriedade é usada principalmente por desenvolvedores de controle. |
| TagName |
Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| TemplateControl |
Obtém ou define uma referência ao modelo que contém esse controle. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controle de servidor atual. (Herdado de Control) |
| TextBoxStyle |
Obtém uma referência a uma coleção de propriedades que definem a aparência das caixas de texto no Login controle. |
| TextLayout |
Especifica a posição de cada rótulo em relação à caixa de texto associada para o Login controle. |
| TitleText |
Obtém ou define o título do Login controle. |
| TitleTextStyle |
Obtém uma referência a uma coleção de propriedades que definem a aparência do texto do título no Login controle. |
| ToolTip |
Obtém ou define o texto exibido quando o ponteiro do mouse passa o mouse sobre o controle do servidor Web. (Herdado de WebControl) |
| UniqueID |
Obtém o identificador exclusivo e hierarquicamente qualificado para o controle do servidor. (Herdado de Control) |
| UserName |
Obtém o nome de usuário inserido pelo usuário. |
| UserNameLabelText |
Obtém ou define o texto do rótulo da UserName caixa de texto. |
| UserNameRequiredErrorMessage |
Obtém ou define a mensagem de erro a ser exibida em um ValidationSummary controle quando o campo nome de usuário é deixado em branco. |
| ValidateRequestMode |
Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador em busca de valores potencialmente perigosos. (Herdado de Control) |
| ValidatorTextStyle |
Obtém uma referência a uma coleção de Style propriedades que definem a aparência das mensagens de erro associadas aos validadores usados pelo Login controle. |
| ViewState |
Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o StateBag objeto não diferencia maiúsculas de minúsculas. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo de estado de exibição desse controle. (Herdado de Control) |
| Visible |
Obtém ou define um valor que indica se um controle de servidor é renderizado como interface do usuário na página. (Herdado de Control) |
| VisibleWhenLoggedIn |
Obtém ou define um valor que indica se o Login controle deve ser mostrado após a autenticação do usuário. |
| Width |
Obtém ou define a largura do controle do servidor Web. (Herdado de WebControl) |
Métodos
| Nome | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Adiciona atributos HTML e estilos que precisam ser renderizados ao especificado HtmlTextWriterTag. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| AddedControl(Control, Int32) |
Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controle do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto do controle do ControlCollection servidor. (Herdado de Control) |
| ApplyStyle(Style) |
Copia todos os elementos nãoblank do estilo especificado para o controle da Web, substituindo quaisquer elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilos de página ao controle. (Herdado de Control) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreamento em tempo de design dos dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Coleta informações sobre o controle do servidor e o Trace entrega na propriedade a ser exibida quando o rastreamento está habilitado para a página. (Herdado de Control) |
| ClearCachedClientID() |
Define o valor armazenado em ClientID cache como |
| ClearChildControlState() |
Exclui as informações de estado de controle para os controles filho do controle do servidor. (Herdado de Control) |
| ClearChildState() |
Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle do servidor. (Herdado de Control) |
| ClearChildViewState() |
Exclui as informações de estado de exibição para todos os controles filho do controle do servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a ClientIDMode propriedade da instância de controle atual e de qualquer controle filho como Inherit. (Herdado de Control) |
| CopyBaseAttributes(WebControl) |
Copia as propriedades não encapsuladas pelo Style objeto do controle de servidor Web especificado para o controle do servidor Web do qual esse método é chamado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| CreateChildControls() |
Cria os controles individuais que compõem o Login controle e associa os manipuladores de eventos a seus eventos. |
| CreateControlCollection() |
Cria um novo ControlCollection objeto para manter os controles filho (literal e servidor) do controle do servidor. (Herdado de Control) |
| CreateControlStyle() |
Cria o objeto de estilo que é usado internamente pela WebControl classe para implementar todas as propriedades relacionadas ao estilo. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| DataBind() |
Associa uma fonte de dados a CompositeControl todos os seus controles filho. (Herdado de CompositeControl) |
| DataBind(Boolean) |
Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho com uma opção para gerar o DataBinding evento. (Herdado de Control) |
| DataBindChildren() |
Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control) |
| Dispose() |
Permite que um controle de servidor execute a limpeza final antes de ser liberado da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Encerra o rastreamento em tempo de design dos dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determina se o controle do servidor contém controles filho. Se isso não acontecer, ele criará controles filho. (Herdado de Control) |
| EnsureID() |
Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FindControl(String, Int32) |
Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o especificado |
| FindControl(String) |
Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro especificado |
| Focus() |
Define o foco de entrada como um controle. (Herdado de Control) |
| GetDesignModeState() |
Obtém dados de tempo de design para um controle. (Herdado de Control) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(String, Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
| GetType() |
Obtém a Type instância atual. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Retorna a parte prefixada da UniqueID propriedade do controle especificado. (Herdado de Control) |
| HasControls() |
Determina se o controle do servidor contém controles filho. (Herdado de Control) |
| HasEvents() |
Retorna um valor que indica se os eventos são registrados para o controle ou quaisquer controles filho. (Herdado de Control) |
| IsLiteralContent() |
Determina se o controle do servidor contém apenas conteúdo literal. (Herdado de Control) |
| LoadControlState(Object) |
Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo SaveControlState() método. (Herdado de Control) |
| LoadViewState(Object) |
Restaura informações de estado de exibição de uma solicitação anterior que foi salva com o SaveViewState() método. |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual, absoluto ou relativo, é mapeado. (Herdado de Control) |
| MemberwiseClone() |
Cria uma cópia superficial da atual Object. (Herdado de Object) |
| MergeStyle(Style) |
Copia todos os elementos nãoblank do estilo especificado para o controle da Web, mas não substituirá nenhum elemento de estilo existente do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| OnAuthenticate(AuthenticateEventArgs) |
Aciona o Authenticate evento para autenticar o usuário. |
| OnBubbleEvent(Object, EventArgs) |
Determina se um evento deve passar um evento para cima na hierarquia de controle de servidor da interface do usuário (interface do usuário) da página. |
| OnDataBinding(EventArgs) |
Aciona o evento DataBinding. (Herdado de Control) |
| OnInit(EventArgs) |
Aciona o evento Init. (Herdado de Control) |
| OnLoad(EventArgs) |
Aciona o evento Load. (Herdado de Control) |
| OnLoggedIn(EventArgs) |
Aciona o LoggedIn evento depois que o usuário faz logon no site e é autenticado. |
| OnLoggingIn(LoginCancelEventArgs) |
Gera o LoggingIn evento quando um usuário envia informações de logon, mas antes que a autenticação ocorra. |
| OnLoginError(EventArgs) |
Aciona o LoginError evento quando uma tentativa de logon falha. |
| OnPreRender(EventArgs) |
Implementa o método base OnPreRender(EventArgs) . |
| OnUnload(EventArgs) |
Aciona o evento Unload. (Herdado de Control) |
| OpenFile(String) |
Obtém um Stream usado para ler um arquivo. (Herdado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui todas as fontes do evento e suas informações ao pai do controle. (Herdado de Control) |
| RecreateChildControls() |
Recria os controles filho em um controle derivado de CompositeControl. (Herdado de CompositeControl) |
| RemovedControl(Control) |
Chamado depois que um controle filho é removido da Controls coleção do Control objeto. (Herdado de Control) |
| Render(HtmlTextWriter) |
Renderiza o formulário de logon usando o gravador HTML especificado. |
| RenderBeginTag(HtmlTextWriter) |
Renderiza a marca de abertura HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| RenderChildren(HtmlTextWriter) |
Gera o conteúdo dos filhos de um controle de servidor para um objeto fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderContents(HtmlTextWriter) |
Renderiza o conteúdo do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gera conteúdo de controle de servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control) |
| RenderControl(HtmlTextWriter) |
O servidor de saída controla o conteúdo de um objeto fornecido HtmlTextWriter e armazena informações de rastreamento sobre o controle se o rastreamento estiver habilitado. (Herdado de Control) |
| RenderEndTag(HtmlTextWriter) |
Renderiza a marca de fechamento HTML do controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
| ResolveAdapter() |
Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control) |
| ResolveClientUrl(String) |
Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL em uma que é utilizável no cliente solicitante. (Herdado de Control) |
| SaveControlState() |
Salva as alterações de estado do controle do servidor que ocorreram desde o momento em que a página foi postada de volta no servidor. (Herdado de Control) |
| SaveViewState() |
Salva qualquer estado modificado após a invocação do TrackViewState() método. |
| SetDesignModeState(IDictionary) |
Define dados de tempo de design para um controle. |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um representante do manipulador de eventos para renderizar o controle do servidor e seu conteúdo em seu controle pai. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Substitui o método base TrackViewState() . |
Eventos
| Nome | Description |
|---|---|
| Authenticate |
Ocorre quando um usuário é autenticado. |
| DataBinding |
Ocorre quando o controle do servidor é associado a uma fonte de dados. (Herdado de Control) |
| Disposed |
Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida do controle do servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| Init |
Ocorre quando o controle do servidor é inicializado, que é a primeira etapa em seu ciclo de vida. (Herdado de Control) |
| Load |
Ocorre quando o controle do servidor é carregado no Page objeto. (Herdado de Control) |
| LoggedIn |
Ocorre quando o usuário faz logon no site e é autenticado. |
| LoggingIn |
Ocorre quando um usuário envia informações de logon antes que a autenticação ocorra. |
| LoginError |
Ocorre quando um erro de logon é detectado. |
| PreRender |
Ocorre depois que o Control objeto é carregado, mas antes da renderização. (Herdado de Control) |
| Unload |
Ocorre quando o controle do servidor é descarregado da memória. (Herdado de Control) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Obtém um atributo do controle Web com o nome especificado. (Herdado de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Define um atributo do controle Web como o nome e o valor especificados. (Herdado de WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Permite que um designer recrie a coleção de controles filho do controle composto no ambiente de tempo de design. (Herdado de CompositeControl) |
| IControlBuilderAccessor.ControlBuilder |
Para obter uma descrição deste membro, consulte ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para obter uma descrição deste membro, consulte GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obter uma descrição deste membro, consulte SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para obter uma descrição deste membro, consulte SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para obter uma descrição deste membro, consulte UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para obter uma descrição deste membro, consulte DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para obter uma descrição deste membro, consulte HasDataBindings. (Herdado de Control) |
| IExpressionsAccessor.Expressions |
Para obter uma descrição deste membro, consulte Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para obter uma descrição deste membro, consulte HasExpressions. (Herdado de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Para obter uma descrição deste membro, consulte AddParsedSubObject(Object). (Herdado de Control) |
Métodos de Extensão
| Nome | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado. |
| EnableDynamicData(INamingContainer, Type, Object) |
Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado. |
| EnableDynamicData(INamingContainer, Type) |
Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado. |
| FindDataSourceControl(Control) |
Retorna a fonte de dados associada ao controle de dados para o controle especificado. |
| FindFieldTemplate(Control, String) |
Retorna o modelo de campo para a coluna especificada no contêiner de nomenclatura do controle especificado. |
| FindMetaTable(Control) |
Retorna o objeto metatável para o controle de dados que contém. |
| GetDefaultValues(INamingContainer) |
Obtém a coleção dos valores padrão para o controle de dados especificado. |
| GetMetaTable(INamingContainer) |
Obtém os metadados da tabela para o controle de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable) |
Define os metadados da tabela para o controle de dados especificado. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Determina se os metadados da tabela estão disponíveis. |
