Condividi tramite

Login Classe

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Fornisce elementi dell'interfaccia utente per l'accesso a un sito Web.

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
Ereditarietà
Object
Control
WebControl
CompositeControl
Login
Attributi
BindableAttribute

Esempio

Nell'esempio di codice seguente viene usato un Login controllo per fornire un'interfaccia utente per l'accesso a un sito Web.

<%@ 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>

Nell'esempio di codice seguente viene illustrato come estendere il Login controllo. Il CustomLogin controllo include un DropDownList controllo che consente agli utenti di scegliere il provider di appartenenza con cui sono autenticati. Questi provider sono configurati in Web.config.) OnLoggingIn Nel metodo la MembershipProvider proprietà viene impostata sul valore selezionato del DropDownList controllo.

Importante

Questo esempio contiene una casella di testo che accetta l'input dell'utente, che rappresenta una potenziale minaccia per la sicurezza. Per impostazione predefinita, ASP.NET pagine Web verificare che l'input dell'utente non includa elementi SCRIPT o HTML. Per altre informazioni, vedere Cenni preliminari sugli exploit di 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

Commenti

In questo argomento:

Introduzione

Il Login controllo è un controllo composito che fornisce tutti gli elementi comuni dell'interfaccia utente necessari per autenticare un utente in un sito Web. Per tutti gli scenari di accesso sono necessari i tre elementi seguenti:

  • Nome utente univoco per identificare l'utente.

  • Password per verificare l'identità dell'utente.

  • Pulsante di accesso per inviare le informazioni di accesso al server.

Il Login controllo fornisce anche gli elementi facoltativi dell'interfaccia utente seguenti che supportano funzioni aggiuntive:

  • Collegamento per un promemoria della password.

  • Casella di controllo Memorizzami per conservare le informazioni di accesso tra le sessioni.

  • Collegamento della Guida per gli utenti che riscontrano problemi di accesso.

  • Collegamento Registra nuovo utente che reindirizza gli utenti a una pagina di registrazione.

  • Testo dell'istruzione visualizzato nel modulo di accesso.

  • Testo di errore personalizzato visualizzato quando l'utente fa clic sul pulsante di accesso senza compilare i campi nome utente o password.

  • Testo di errore personalizzato visualizzato se l'account di accesso ha esito negativo.

  • Azione personalizzata che si verifica quando l'accesso ha esito positivo.

  • Un modo per nascondere il controllo di accesso se l'utente ha già eseguito l'accesso al sito.

Per una tabella che mostra quali controlli sono obbligatori e quali sono facoltativi, vedere LayoutTemplate la proprietà .

Annotazioni

Se non si ha familiarità con il set di controlli di accesso disponibili in ASP.NET, vedere ASP.NET Panoramica dei controlli di accesso prima di continuare. Per un elenco di altri argomenti relativi ai controlli di accesso e all'appartenenza, vedere Gestione degli utenti tramite l'appartenenza.

Importante

L'accettazione dell'input dell'utente è una potenziale minaccia per la sicurezza. Gli utenti malintenzionati possono inviare dati destinati a esporre vulnerabilità o eseguire programmi che provano a generare password. Per migliorare la sicurezza quando si lavora con l'input dell'utente, è necessario usare le funzionalità di convalida del controllo e proteggere i provider di dati configurati per il controllo. Per altre informazioni, vedere Protezione dei controlli di accesso, Procedure di sicurezza di base per le applicazioni Web e Protezione dell'appartenenza.

Il Login controllo usa un provider di appartenenze per ottenere le credenziali utente. A meno che non si specifichi diversamente, il Login controllo utilizza il provider di appartenenze predefinito definito nel file di Web.config. Per specificare un provider diverso, impostare la MembershipProvider proprietà su uno dei nomi dei provider di appartenenze definiti nel file di Web.config dell'applicazione. Per altre informazioni, vedere Provider di appartenenze.

Se si vuole usare un servizio di autenticazione personalizzato, è possibile usare il OnAuthenticate metodo per chiamare il servizio.

Stili e modelli

L'aspetto del Login controllo è completamente personalizzabile tramite modelli e impostazioni di stile. Tutti i messaggi di testo dell'interfaccia utente sono personalizzabili anche tramite le proprietà della Login classe . Il testo dell'interfaccia predefinito viene localizzato automaticamente in base all'impostazione delle impostazioni locali nel server.

Se il Login controllo viene personalizzato con i modelli, la AccessKey proprietà e la TabIndex proprietà vengono ignorate. In questo caso, impostare direttamente la AccessKey proprietà e la TabIndex proprietà di ogni controllo figlio del modello.

Login le proprietà del controllo rappresentate da caselle di testo, ad esempio UserName e Password, sono accessibili durante tutte le fasi del ciclo di vita della pagina. Il controllo rileverà le modifiche apportate dall'utente finale tramite l'evento TextChanged attivato dalle caselle di testo.

Annotazioni

Se si incorpora il Login controllo in un WizardStep oggetto , impostare in modo esplicito la ActiveStepIndex proprietà in un Page_Load gestore eventi se l'utente è autenticato. Il Wizard controllo non passa automaticamente all'oggetto successivo WizardStep in questo scenario.

La tabella seguente elenca le proprietà dello Login stile del controllo e spiega quale elemento dell'interfaccia utente influisce su ogni proprietà di stile. Per un elenco delle proprietà a cui si applica ogni stile, vedere la documentazione per le singole proprietà di stile.

Proprietà Style Elemento dell'interfaccia utente interessato
BorderPadding Spazio tra il contenuto del controllo e il bordo del controllo.
CheckBoxStyle Ricordami la casella di controllo.
FailureTextStyle Testo dell'errore di accesso.
InstructionTextStyle Testo informativo nella pagina che indica agli utenti come usare il controllo.
LabelStyle Etichette per tutti i campi di input, ad esempio caselle di testo.
TextBoxStyle Campi di input della voce di testo.
TitleTextStyle Testo del titolo.
ValidatorTextStyle Testo visualizzato all'utente quando un tentativo di accesso non riesce a causa di errori di convalida.
HyperLinkStyle Collegamenti ad altre pagine.
LoginButtonStyle Pulsante Di accesso.

Raggruppamenti di convalida

Alle UserName proprietà RequiredFieldValidator e Password sono associati controlli per impedire agli utenti di inviare la pagina senza fornire le informazioni necessarie.

Il Login controllo usa un gruppo di convalida in modo che altri campi nella stessa pagina del Login controllo possano essere convalidati separatamente. Per impostazione predefinita, la ID proprietà del Login controllo viene utilizzata come nome del gruppo di convalida. Ad esempio, un Login controllo con ID "Login1" userà un nome di gruppo di convalida "Login1". Se si desidera impostare il gruppo di convalida di cui fa parte il Login controllo, è necessario modificare il nome del gruppo di convalida e modificare il nome del gruppo di convalida.

Applicazione di stili CSS

Il Login controllo consente di specificare le regole di stile CSS nel markup. Se si usano modelli per personalizzare l'aspetto del Login controllo, è possibile specificare gli stili CSS nel markup nei modelli. In tal caso, non è necessaria alcuna tabella esterna aggiuntiva. È possibile impedire il rendering della tabella impostando la RenderOuterTable proprietà su false.

Accessibilità

Per informazioni su come configurare questo controllo in modo che generi markup conforme agli standard di accessibilità, vedere Accessibilità in Visual Studio e ASP.NET e controlli ASP.NET e accessibilità.

Sintassi dichiarativa

<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>

Costruttori

Nome Descrizione
Login()

Crea una nuova istanza del Login controllo .

Campi

Nome Descrizione
LoginButtonCommandName

Rappresenta il nome del comando associato al pulsante di accesso.

Proprietà

Nome Descrizione
AccessKey

Ottiene o imposta la chiave di accesso che consente di passare rapidamente al controllo server Web.

(Ereditato da WebControl)
Adapter

Ottiene l'adattatore specifico del browser per il controllo .

(Ereditato da Control)
AppRelativeTemplateSourceDirectory

Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl che contiene questo controllo.

(Ereditato da Control)
Attributes

Ottiene la raccolta di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo.

(Ereditato da WebControl)
BackColor

Ottiene o imposta il colore di sfondo del controllo server Web.

(Ereditato da WebControl)
BindingContainer

Ottiene il controllo che contiene il data binding di questo controllo.

(Ereditato da Control)
BorderColor

Ottiene o imposta il colore del bordo del controllo Web.

(Ereditato da WebControl)
BorderPadding

Ottiene o imposta la quantità di spaziatura interna all'interno dei bordi del Login controllo.
BorderStyle

Ottiene o imposta lo stile del bordo del controllo server Web.

(Ereditato da WebControl)
BorderWidth

Ottiene o imposta la larghezza del bordo del controllo server Web.

(Ereditato da WebControl)
CheckBoxStyle

Ottiene un riferimento a un Style oggetto che definisce le impostazioni per la casella di controllo Memorizzami.
ChildControlsCreated

Ottiene un valore che indica se sono stati creati i controlli figlio del controllo server.

(Ereditato da Control)
ClientID

Ottiene l'ID di controllo per il markup HTML generato da ASP.NET.

(Ereditato da Control)
ClientIDMode

Ottiene o imposta l'algoritmo utilizzato per generare il valore della ClientID proprietà .

(Ereditato da Control)
ClientIDSeparator

Ottiene un valore di carattere che rappresenta il carattere separatore utilizzato nella ClientID proprietà .

(Ereditato da Control)
Context

Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente.

(Ereditato da Control)
Controls

Ottiene un ControlCollection oggetto che rappresenta i controlli figlio in un oggetto CompositeControl.

(Ereditato da CompositeControl)
ControlStyle

Ottiene lo stile del controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
ControlStyleCreated

Ottiene un valore che indica se è stato creato un Style oggetto per la ControlStyle proprietà . Questa proprietà viene usata principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
CreateUserIconUrl

Ottiene la posizione di un'immagine da visualizzare accanto al collegamento a una pagina di registrazione per i nuovi utenti.
CreateUserText

Ottiene o imposta il testo di un collegamento a una pagina di registrazione per i nuovi utenti.
CreateUserUrl

Ottiene o imposta l'URL della pagina di registrazione del nuovo utente.
CssClass

Ottiene o imposta la classe CSS (Cascading Style Sheet) sottoposta a rendering dal controllo server Web nel client.

(Ereditato da WebControl)
DataItemContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer.

(Ereditato da Control)
DataKeysContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl.

(Ereditato da Control)
DesignMode

Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione.

(Ereditato da Control)
DestinationPageUrl

Ottiene o imposta l'URL della pagina visualizzata all'utente quando un tentativo di accesso ha esito positivo.
DisplayRememberMe

Ottiene o imposta un valore che indica se visualizzare una casella di controllo per consentire all'utente di controllare se un cookie persistente viene inviato al browser.
Enabled

Ottiene o imposta un valore che indica se il controllo server Web è abilitato.

(Ereditato da WebControl)
EnableTheming

Ottiene o imposta un valore che indica se i temi si applicano a questo controllo.

(Ereditato da WebControl)
EnableViewState

Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione di tutti i controlli figlio contenuti, al client richiedente.

(Ereditato da Control)
Events

Ottiene un elenco di delegati del gestore eventi per il controllo . Questa proprietà è di sola lettura.

(Ereditato da Control)
FailureAction

Ottiene o imposta l'azione che si verifica quando un tentativo di accesso ha esito negativo.
FailureText

Ottiene o imposta il testo visualizzato quando un tentativo di accesso non riesce.
FailureTextStyle

Ottiene un riferimento a una raccolta di proprietà che definiscono l'aspetto del testo di errore nel Login controllo .
Font

Ottiene le proprietà del tipo di carattere associate al controllo server Web.

(Ereditato da WebControl)
ForeColor

Ottiene o imposta il colore di primo piano (in genere il colore del testo) del controllo server Web.

(Ereditato da WebControl)
HasAttributes

Ottiene un valore che indica se il controllo dispone di attributi impostati.

(Ereditato da WebControl)
HasChildViewState

Ottiene un valore che indica se i controlli figlio del controllo server corrente hanno impostazioni dello stato di visualizzazione salvate.

(Ereditato da Control)
Height

Ottiene o imposta l'altezza del controllo server Web.

(Ereditato da WebControl)
HelpPageIconUrl

Ottiene il percorso di un'immagine da visualizzare accanto al collegamento alla pagina della Guida di accesso.
HelpPageText

Ottiene o imposta il testo di un collegamento alla pagina della Guida di accesso.
HelpPageUrl

Ottiene o imposta l'URL della pagina della Guida di accesso.
HyperLinkStyle

Ottiene un riferimento a una raccolta di proprietà che definiscono l'aspetto dei collegamenti ipertestuali nel Login controllo .
ID

Ottiene o imposta l'identificatore programmatico assegnato al controllo server.

(Ereditato da Control)
IdSeparator

Ottiene il carattere utilizzato per separare gli identificatori di controllo.

(Ereditato da Control)
InstructionText

Ottiene o imposta il testo dell'istruzione di accesso per l'utente.
InstructionTextStyle

Ottiene un riferimento a un TableItemStyle oggetto che definisce le impostazioni per il testo dell'istruzione nel Login controllo .
IsChildControlStateCleared

Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo hanno uno stato di controllo.

(Ereditato da Control)
IsEnabled

Ottiene un valore che indica se il controllo è abilitato.

(Ereditato da WebControl)
IsTrackingViewState

Ottiene un valore che indica se il controllo server salva le modifiche apportate allo stato di visualizzazione.

(Ereditato da Control)
IsViewStateEnabled

Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo.

(Ereditato da Control)
LabelStyle

Ottiene un riferimento a un TableItemStyle oggetto che definisce le impostazioni per Login le etichette di controllo.
LayoutTemplate

Ottiene o imposta il modello utilizzato per visualizzare il Login controllo .
LoadViewStateByID

Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione in ID base al posto dell'indice.

(Ereditato da Control)
LoginButtonImageUrl

Ottiene o imposta l'URL di un'immagine da utilizzare per il pulsante di accesso.
LoginButtonStyle

Ottiene un riferimento all'oggetto Style che consente di impostare l'aspetto del pulsante di accesso nel Login controllo .
LoginButtonText

Ottiene o imposta il testo per il Login pulsante di accesso del controllo.
LoginButtonType

Ottiene o imposta il tipo di pulsante da utilizzare durante il rendering del Login pulsante.
MembershipProvider

Ottiene o imposta il nome del provider di dati di appartenenza utilizzato dal controllo .
NamingContainer

Ottiene un riferimento al contenitore di denominazione del controllo server, che crea uno spazio dei nomi univoco per la differenziazione tra i controlli server con lo stesso ID valore della proprietà.

(Ereditato da Control)
Orientation

Ottiene o imposta un valore che specifica la posizione degli elementi del Login controllo nella pagina.
Page

Ottiene un riferimento all'istanza Page che contiene il controllo server.

(Ereditato da Control)
Parent

Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli pagina.

(Ereditato da Control)
Password

Ottiene la password immessa dall'utente.
PasswordLabelText

Ottiene o imposta il testo dell'etichetta per la Password casella di testo.
PasswordRecoveryIconUrl

Ottiene la posizione di un'immagine da visualizzare accanto al collegamento alla pagina di ripristino della password.
PasswordRecoveryText

Ottiene o imposta il testo di un collegamento alla pagina di ripristino della password.
PasswordRecoveryUrl

Ottiene o imposta l'URL della pagina di ripristino della password.
PasswordRequiredErrorMessage

Ottiene o imposta il messaggio di errore da visualizzare in un ValidationSummary controllo quando il campo della password viene lasciato vuoto.
RememberMeSet

Ottiene o imposta un valore che indica se inviare un cookie di autenticazione permanente al browser dell'utente.
RememberMeText

Ottiene o imposta il testo dell'etichetta per la casella di controllo Memorizzami.
RenderingCompatibility

Ottiene un valore che specifica la versione ASP.NET con cui è stato eseguito il rendering del codice HTML sarà compatibile.

(Ereditato da Control)
RenderOuterTable

Ottiene o imposta un valore che indica se il controllo racchiude il codice HTML sottoposto a rendering in un table elemento per applicare stili inline.
Site

Ottiene informazioni sul contenitore che ospita il controllo corrente durante il rendering in un'area di progettazione.

(Ereditato da Control)
SkinID

Ottiene o imposta l'interfaccia da applicare al controllo.

(Ereditato da WebControl)
Style

Ottiene una raccolta di attributi di testo di cui verrà eseguito il rendering come attributo di stile sul tag esterno del controllo server Web.

(Ereditato da WebControl)
SupportsDisabledAttribute

Ottiene un valore che indica se il controllo deve impostare l'attributo dell'elemento disabled HTML sottoposto a rendering su "disabled" quando la proprietà del IsEnabled controllo è false.

(Ereditato da CompositeControl)
TabIndex

Ottiene o imposta l'indice della scheda del controllo server Web.

(Ereditato da WebControl)
TagKey

Ottiene il HtmlTextWriterTag valore che corrisponde a un Login controllo . Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli.
TagName

Ottiene il nome del tag di controllo. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
TemplateControl

Ottiene o imposta un riferimento al modello che contiene questo controllo.

(Ereditato da Control)
TemplateSourceDirectory

Ottiene la directory virtuale dell'oggetto Page o UserControl che contiene il controllo server corrente.

(Ereditato da Control)
TextBoxStyle

Ottiene un riferimento a una raccolta di proprietà che definiscono l'aspetto delle caselle di testo nel Login controllo .
TextLayout

Specifica la posizione di ogni etichetta rispetto alla casella di testo associata per il Login controllo .
TitleText

Ottiene o imposta il titolo del Login controllo.
TitleTextStyle

Ottiene un riferimento a una raccolta di proprietà che definiscono l'aspetto del testo del Login titolo nel controllo .
ToolTip

Ottiene o imposta il testo visualizzato quando il puntatore del mouse passa il mouse sul controllo server Web.

(Ereditato da WebControl)
UniqueID

Ottiene l'identificatore univoco e qualificato gerarchicamente per il controllo server.

(Ereditato da Control)
UserName

Ottiene il nome utente immesso dall'utente.
UserNameLabelText

Ottiene o imposta il testo dell'etichetta per la UserName casella di testo.
UserNameRequiredErrorMessage

Ottiene o imposta il messaggio di errore da visualizzare in un ValidationSummary controllo quando il campo nome utente viene lasciato vuoto.
ValidateRequestMode

Ottiene o imposta un valore che indica se il controllo controlla l'input client dal browser per individuare valori potenzialmente pericolosi.

(Ereditato da Control)
ValidatorTextStyle

Ottiene un riferimento a una raccolta di Style proprietà che definiscono l'aspetto dei messaggi di errore associati ai validator utilizzati dal Login controllo .
ViewState

Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste per la stessa pagina.

(Ereditato da Control)
ViewStateIgnoresCase

Ottiene un valore che indica se l'oggetto StateBag non fa distinzione tra maiuscole e minuscole.

(Ereditato da Control)
ViewStateMode

Ottiene o imposta la modalità dello stato di visualizzazione di questo controllo.

(Ereditato da Control)
Visible

Ottiene o imposta un valore che indica se il rendering di un controllo server viene eseguito come interfaccia utente nella pagina.

(Ereditato da Control)
VisibleWhenLoggedIn

Ottiene o imposta un valore che indica se visualizzare il Login controllo dopo l'autenticazione dell'utente.
Width

Ottiene o imposta la larghezza del controllo server Web.

(Ereditato da WebControl)

Metodi

Nome Descrizione
AddAttributesToRender(HtmlTextWriter)

Aggiunge attributi e stili HTML di cui è necessario eseguire il rendering nell'oggetto specificato HtmlTextWriterTag. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
AddedControl(Control, Int32)

Chiamato dopo l'aggiunta di un controllo figlio all'insieme Controls dell'oggetto Control .

(Ereditato da Control)
AddParsedSubObject(Object)

Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto del ControlCollection controllo server.

(Ereditato da Control)
ApplyStyle(Style)

Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, sovrascrivendo tutti gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
ApplyStyleSheetSkin(Page)

Applica le proprietà di stile definite nel foglio di stile della pagina al controllo .

(Ereditato da Control)
BeginRenderTracing(TextWriter, Object)

Inizia la traccia in fase di progettazione dei dati di rendering.

(Ereditato da Control)
BuildProfileTree(String, Boolean)

Raccoglie informazioni sul controllo server e le distribuisce alla Trace proprietà da visualizzare quando la traccia è abilitata per la pagina.

(Ereditato da Control)
ClearCachedClientID()

Imposta il valore memorizzato nella ClientID cache su null.

(Ereditato da Control)
ClearChildControlState()

Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server.

(Ereditato da Control)
ClearChildState()

Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server.

(Ereditato da Control)
ClearChildViewState()

Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server.

(Ereditato da Control)
ClearEffectiveClientIDMode()

Imposta la ClientIDMode proprietà dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit.

(Ereditato da Control)
CopyBaseAttributes(WebControl)

Copia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web da cui viene chiamato questo metodo. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
CreateChildControls()

Crea i singoli controlli che costituiscono il Login controllo e associa i gestori eventi ai relativi eventi.
CreateControlCollection()

Crea un nuovo ControlCollection oggetto per contenere i controlli figlio (sia letterali che server) del controllo server.

(Ereditato da Control)
CreateControlStyle()

Crea l'oggetto stile utilizzato internamente dalla WebControl classe per implementare tutte le proprietà correlate allo stile. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
DataBind()

Associa un'origine CompositeControl dati a e a tutti i relativi controlli figlio.

(Ereditato da CompositeControl)
DataBind(Boolean)

Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding .

(Ereditato da Control)
DataBindChildren()

Associa un'origine dati ai controlli figlio del controllo server.

(Ereditato da Control)
Dispose()

Consente a un controllo server di eseguire la pulizia finale prima che venga rilasciata dalla memoria.

(Ereditato da Control)
EndRenderTracing(TextWriter, Object)

Termina la traccia in fase di progettazione dei dati di rendering.

(Ereditato da Control)
EnsureChildControls()

Determina se il controllo server contiene controlli figlio. In caso contrario, crea controlli figlio.

(Ereditato da Control)
EnsureID()

Crea un identificatore per i controlli a cui non è assegnato un identificatore.

(Ereditato da Control)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
FindControl(String, Int32)

Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato id e un numero intero, specificato nel pathOffset parametro , che facilita la ricerca. Non è consigliabile eseguire l'override di questa versione del FindControl metodo .

(Ereditato da Control)
FindControl(String)

Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato id .

(Ereditato da Control)
Focus()

Imposta lo stato attivo dell'input su un controllo .

(Ereditato da Control)
GetDesignModeState()

Ottiene i dati in fase di progettazione per un controllo .

(Ereditato da Control)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetRouteUrl(Object)

Ottiene l'URL che corrisponde a un set di parametri di route.

(Ereditato da Control)
GetRouteUrl(RouteValueDictionary)

Ottiene l'URL che corrisponde a un set di parametri di route.

(Ereditato da Control)
GetRouteUrl(String, Object)

Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route.

(Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)

Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route.

(Ereditato da Control)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
GetUniqueIDRelativeTo(Control)

Restituisce la parte con prefisso della UniqueID proprietà del controllo specificato.

(Ereditato da Control)
HasControls()

Determina se il controllo server contiene controlli figlio.

(Ereditato da Control)
HasEvents()

Restituisce un valore che indica se gli eventi vengono registrati per il controllo o per i controlli figlio.

(Ereditato da Control)
IsLiteralContent()

Determina se il controllo server contiene solo contenuto letterale.

(Ereditato da Control)
LoadControlState(Object)

Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal SaveControlState() metodo .

(Ereditato da Control)
LoadViewState(Object)

Ripristina le informazioni sullo stato di visualizzazione da una richiesta precedente salvata con il SaveViewState() metodo .
MapPathSecure(String)

Recupera il percorso fisico a cui viene mappato un percorso virtuale, assoluto o relativo.

(Ereditato da Control)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
MergeStyle(Style)

Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, ma non sovrascriverà gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
OnAuthenticate(AuthenticateEventArgs)

Genera l'evento Authenticate per autenticare l'utente.
OnBubbleEvent(Object, EventArgs)

Determina se passare un evento alla gerarchia di controllo server dell'interfaccia utente della pagina.
OnDataBinding(EventArgs)

Genera l'evento DataBinding.

(Ereditato da Control)
OnInit(EventArgs)

Genera l'evento Init.

(Ereditato da Control)
OnLoad(EventArgs)

Genera l'evento Load.

(Ereditato da Control)
OnLoggedIn(EventArgs)

Genera l'evento LoggedIn dopo che l'utente accede al sito Web ed è stato autenticato.
OnLoggingIn(LoginCancelEventArgs)

Genera l'evento LoggingIn quando un utente invia informazioni di accesso, ma prima che venga eseguita l'autenticazione.
OnLoginError(EventArgs)

Genera l'evento LoginError quando un tentativo di accesso ha esito negativo.
OnPreRender(EventArgs)

Implementa il metodo di base OnPreRender(EventArgs) .
OnUnload(EventArgs)

Genera l'evento Unload.

(Ereditato da Control)
OpenFile(String)

Ottiene un Stream oggetto utilizzato per leggere un file.

(Ereditato da Control)
RaiseBubbleEvent(Object, EventArgs)

Assegna tutte le origini dell'evento e le relative informazioni all'elemento padre del controllo.

(Ereditato da Control)
RecreateChildControls()

Ricrea i controlli figlio in un controllo derivato da CompositeControl.

(Ereditato da CompositeControl)
RemovedControl(Control)

Chiamato dopo che un controllo figlio viene rimosso dall'insieme Controls dell'oggetto Control .

(Ereditato da Control)
Render(HtmlTextWriter)

Esegue il rendering del modulo di accesso usando il writer HTML specificato.
RenderBeginTag(HtmlTextWriter)

Esegue il rendering del tag di apertura HTML del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
RenderChildren(HtmlTextWriter)

Restituisce il contenuto degli elementi figlio di un controllo server in un oggetto fornito HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client.

(Ereditato da Control)
RenderContents(HtmlTextWriter)

Esegue il rendering del contenuto del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter .

(Ereditato da Control)
RenderControl(HtmlTextWriter)

Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata.

(Ereditato da Control)
RenderEndTag(HtmlTextWriter)

Esegue il rendering del tag di chiusura HTML del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
ResolveAdapter()

Ottiene l'adattatore di controllo responsabile del rendering del controllo specificato.

(Ereditato da Control)
ResolveClientUrl(String)

Ottiene un URL che può essere utilizzato dal browser.

(Ereditato da Control)
ResolveUrl(String)

Converte un URL in un URL utilizzabile nel client richiedente.

(Ereditato da Control)
SaveControlState()

Salva le modifiche apportate allo stato del controllo server dopo il postback della pagina al server.

(Ereditato da Control)
SaveViewState()

Salva qualsiasi stato modificato dopo che il TrackViewState() metodo è stato richiamato.
SetDesignModeState(IDictionary)

Imposta i dati in fase di progettazione per un controllo .
SetRenderMethodDelegate(RenderMethod)

Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre.

(Ereditato da Control)
SetTraceData(Object, Object, Object)

Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia.

(Ereditato da Control)
SetTraceData(Object, Object)

Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando la chiave dei dati di traccia e il valore dei dati di traccia.

(Ereditato da Control)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
TrackViewState()

Esegue l'override del metodo di base TrackViewState() .

Eventi

Nome Descrizione
Authenticate

Si verifica quando un utente viene autenticato.
DataBinding

Si verifica quando il controllo server viene associato a un'origine dati.

(Ereditato da Control)
Disposed

Si verifica quando viene rilasciato un controllo server dalla memoria, ovvero l'ultima fase del ciclo di vita del controllo server quando viene richiesta una pagina ASP.NET.

(Ereditato da Control)
Init

Si verifica quando il controllo server viene inizializzato, ovvero il primo passaggio del ciclo di vita.

(Ereditato da Control)
Load

Si verifica quando il controllo server viene caricato nell'oggetto Page .

(Ereditato da Control)
LoggedIn

Si verifica quando l'utente accede al sito Web ed è stato autenticato.
LoggingIn

Si verifica quando un utente invia informazioni di accesso, prima che venga eseguita l'autenticazione.
LoginError

Si verifica quando viene rilevato un errore di accesso.
PreRender

Si verifica dopo il caricamento dell'oggetto Control , ma prima del rendering.

(Ereditato da Control)
Unload

Si verifica quando il controllo server viene scaricato dalla memoria.

(Ereditato da Control)

Implementazioni dell'interfaccia esplicita

Nome Descrizione
IAttributeAccessor.GetAttribute(String)

Ottiene un attributo del controllo Web con il nome specificato.

(Ereditato da WebControl)
IAttributeAccessor.SetAttribute(String, String)

Imposta un attributo del controllo Web sul nome e sul valore specificati.

(Ereditato da WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Consente a una finestra di progettazione di ricreare la raccolta di controlli figlio del controllo composito nell'ambiente in fase di progettazione.

(Ereditato da CompositeControl)
IControlBuilderAccessor.ControlBuilder

Per una descrizione di questo membro, vedere ControlBuilder.

(Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()

Per una descrizione di questo membro, vedere GetDesignModeState().

(Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary).

(Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Per una descrizione di questo membro, vedere SetOwnerControl(Control).

(Ereditato da Control)
IControlDesignerAccessor.UserData

Per una descrizione di questo membro, vedere UserData.

(Ereditato da Control)
IDataBindingsAccessor.DataBindings

Per una descrizione di questo membro, vedere DataBindings.

(Ereditato da Control)
IDataBindingsAccessor.HasDataBindings

Per una descrizione di questo membro, vedere HasDataBindings.

(Ereditato da Control)
IExpressionsAccessor.Expressions

Per una descrizione di questo membro, vedere Expressions.

(Ereditato da Control)
IExpressionsAccessor.HasExpressions

Per una descrizione di questo membro, vedere HasExpressions.

(Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)

Per una descrizione di questo membro, vedere AddParsedSubObject(Object).

(Ereditato da Control)

Metodi di estensione

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

Abilita il comportamento dei dati dinamici per il controllo dati specificato.
EnableDynamicData(INamingContainer, Type, Object)

Abilita il comportamento dei dati dinamici per il controllo dati specificato.
EnableDynamicData(INamingContainer, Type)

Abilita il comportamento dei dati dinamici per il controllo dati specificato.
FindDataSourceControl(Control)

Restituisce l'origine dati associata al controllo dati per il controllo specificato.
FindFieldTemplate(Control, String)

Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.
FindMetaTable(Control)

Restituisce l'oggetto metatable per il controllo dati contenitore.
GetDefaultValues(INamingContainer)

Ottiene la raccolta dei valori predefiniti per il controllo dati specificato.
GetMetaTable(INamingContainer)

Ottiene i metadati della tabella per il controllo dati specificato.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Imposta i metadati della tabella e il mapping dei valori predefiniti per il controllo dati specificato.
SetMetaTable(INamingContainer, MetaTable, Object)

Imposta i metadati della tabella e il mapping dei valori predefiniti per il controllo dati specificato.
SetMetaTable(INamingContainer, MetaTable)

Imposta i metadati della tabella per il controllo dati specificato.
TryGetMetaTable(INamingContainer, MetaTable)

Determina se i metadati della tabella sono disponibili.

Si applica a

Vedi anche