Login Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce gli 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à
- Attributi
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 appartenenze con cui vengono 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, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per altre informazioni, vedere Cenni preliminari sugli attacchi tramite 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 è già connesso al sito.
Per una tabella che mostra quali controlli sono obbligatori e quali sono facoltativi, vedere LayoutTemplate la proprietà .
Nota
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 tentano di generare password. Per migliorare la sicurezza quando si lavora con l'input dell'utente, è necessario usare le funzionalità di convalida del controllo e proteggere tutti 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. Se non diversamente specificato, 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 predefinito dell'interfaccia 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.
Nota
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.
Nella tabella seguente sono elencate le proprietà dello stile del Login controllo e viene spiegato 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 istruzioni 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 voce di testo. |
TitleTextStyle | Testo 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
Le UserName proprietà e Password sono RequiredFieldValidator associate ai controlli per impedire agli utenti di inviare la pagina senza fornire 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 usata come nome del gruppo di convalida. Ad esempio, un Login controllo con l'ID "Login1" userà un nome di gruppo di convalida "Login1". Se si vuole impostare il gruppo di convalida che il Login controllo fa parte del 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 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 questo 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
Login() |
Crea una nuova istanza del controllo Login. |
Campi
LoginButtonCommandName |
Rappresenta il nome di comando associato al pulsante di accesso. |
Proprietà
AccessKey |
Ottiene o imposta il tasto di scelta che consente di accedere 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 contenente questo controllo. (Ereditato da Control) |
Attributes |
Ottiene l'insieme 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 contenente l'associazione dati del controllo corrente. (Ereditato da Control) |
BorderColor |
Ottiene o imposta il colore del bordo del controllo Web. (Ereditato da WebControl) |
BorderPadding |
Ottiene o imposta la spaziatura interna ai bordi del controllo Login. |
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 oggetto Style che definisce le impostazioni per la casella di controllo di memorizzazione dei dati. |
ChildControlsCreated |
Ottiene un valore che indica se i controlli figli del controllo server sono stati creati. (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 proprietà ClientID. (Ereditato da Control) |
ClientIDSeparator |
Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID. (Ereditato da Control) |
Context |
Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control) |
Controls |
Ottiene un oggetto ControlCollection che rappresenta i controlli figlio di un oggetto CompositeControl. (Ereditato da CompositeControl) |
ControlStyle |
Ottiene lo stile del controllo server Web. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
ControlStyleCreated |
Ottiene un valore che indica se è stato creato un oggetto Style per la proprietà ControlStyle. Questa proprietà viene utilizzata 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 nuovi utenti. |
CreateUserText |
Ottiene o imposta il testo di un collegamento a una pagina di registrazione per nuovi utenti. |
CreateUserUrl |
Ottiene o imposta l'URL della pagina di registrazione di nuovi utenti. |
CssClass |
Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul 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 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 relativo 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 al controllo vengono applicati i temi. (Ereditato da WebControl) |
EnableViewState |
Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente. (Ereditato da Control) |
Events |
Ottiene un elenco dei 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 il tentativo di accesso non riesce. |
FailureText |
Ottiene o imposta il testo visualizzato quando un tentativo di accesso non riesce. |
FailureTextStyle |
Ottiene un riferimento a un insieme di proprietà che definiscono l'aspetto dei messaggi di errore nel controllo Login. |
Font |
Ottiene le proprietà del 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 sono impostati attributi per il controllo. (Ereditato da WebControl) |
HasChildViewState |
Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono 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 all'accesso. |
HelpPageText |
Ottiene o imposta il testo di un collegamento alla pagina della Guida relativa all'accesso. |
HelpPageUrl |
Ottiene o imposta l'URL della pagina della Guida relativa all'accesso. |
HyperLinkStyle |
Ottiene un riferimento a un insieme di proprietà che definiscono l'aspetto dei collegamenti ipertestuali nel controllo Login. |
ID |
Ottiene o imposta l'identificatore a livello di codice 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 di istruzioni di accesso per l'utente. |
InstructionTextStyle |
Ottiene un riferimento a un oggetto TableItemStyle che definisce le impostazioni per il testo di istruzioni nel controllo Login. |
IsChildControlStateCleared |
Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del 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 allo stato di visualizzazione. (Ereditato da Control) |
IsViewStateEnabled |
Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente. (Ereditato da Control) |
LabelStyle |
Ottiene un riferimento a un oggetto TableItemStyle che definisce le impostazioni per le etichette del controllo Login. |
LayoutTemplate |
Ottiene o imposta il modello utilizzato per visualizzare il controllo Login. |
LoadViewStateByID |
Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'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 controllo Login. |
LoginButtonText |
Ottiene o imposta il testo per il pulsante di accesso del controllo Login. |
LoginButtonType |
Ottiene o imposta il tipo di pulsante da utilizzare quando viene eseguito il rendering del pulsante Login. |
MembershipProvider |
Ottiene o imposta il nome del provider dei dati di appartenenze utilizzato dal controllo. |
NamingContainer |
Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà ID. (Ereditato da Control) |
Orientation |
Ottiene o imposta un valore che specifica la posizione degli elementi del controllo Login 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 della pagina. (Ereditato da Control) |
Password |
Ottiene la password immessa dall'utente. |
PasswordLabelText |
Ottiene o imposta il testo dell'etichetta per la casella di testo Password. |
PasswordRecoveryIconUrl |
Ottiene la posizione di un'immagine da visualizzare accanto al collegamento alla pagina di recupero della password. |
PasswordRecoveryText |
Ottiene o imposta il testo di un collegamento alla pagina di recupero della password. |
PasswordRecoveryUrl |
Ottiene o imposta l'URL della pagina di recupero della password. |
PasswordRequiredErrorMessage |
Ottiene o imposta il messaggio di errore da visualizzare in un controllo ValidationSummary quando il campo della password viene lasciato vuoto. |
RememberMeSet |
Ottiene o imposta un valore che indica se inviare un cookie di autenticazione persistente al browser dell'utente. |
RememberMeText |
Ottiene o imposta il testo dell'etichetta per la casella di controllo di memorizzazione dei dati. |
RenderingCompatibility |
Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering. (Ereditato da Control) |
RenderOuterTable |
Ottiene o imposta un valore che indica se il controllo racchiude il codice HTML di cui è stato eseguito il rendering in un elemento |
Site |
Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. (Ereditato da Control) |
SkinID |
Ottiene o imposta l'interfaccia personalizzata da applicare al controllo. (Ereditato da WebControl) |
Style |
Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. (Ereditato da WebControl) |
SupportsDisabledAttribute |
Ottiene un valore che indica se il controllo deve impostare l'attributo |
TabIndex |
Ottiene o imposta l'indice di tabulazione del controllo server Web. (Ereditato da WebControl) |
TagKey |
Ottiene il valore HtmlTextWriterTag che corrisponde a un controllo Login. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. |
TagName |
Ottiene il nome del tag del controllo. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
TemplateControl |
Ottiene o imposta un riferimento al modello che contiene il controllo. (Ereditato da Control) |
TemplateSourceDirectory |
Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente. (Ereditato da Control) |
TextBoxStyle |
Ottiene un riferimento a un insieme di proprietà che definiscono l'aspetto delle caselle di testo nel controllo Login. |
TextLayout |
Specifica la posizione di ciascuna etichetta relativa alla casella di testo associata per il controllo Login. |
TitleText |
Ottiene o imposta il titolo del controllo Login. |
TitleTextStyle |
Ottiene un riferimento a un insieme di proprietà che definiscono l'aspetto del testo del titolo nel controllo Login. |
ToolTip |
Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. (Ereditato da WebControl) |
UniqueID |
Ottiene l'identificatore univoco 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 casella di testo UserName. |
UserNameRequiredErrorMessage |
Ottiene o imposta il messaggio di errore da visualizzare in un controllo ValidationSummary quando il campo del nome utente viene lasciato vuoto. |
ValidateRequestMode |
Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser. (Ereditato da Control) |
ValidatorTextStyle |
Ottiene un riferimento a un insieme di proprietà Style che definiscono l'aspetto dei messaggi di errore associati dai validator utilizzati dal controllo Login. |
ViewState |
Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina. (Ereditato da Control) |
ViewStateIgnoresCase |
Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole. (Ereditato da Control) |
ViewStateMode |
Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo. (Ereditato da Control) |
Visible |
Ottiene o imposta un valore che indica se viene eseguito il rendering di un controllo server come interfaccia utente nella pagina. (Ereditato da Control) |
VisibleWhenLoggedIn |
Ottiene o imposta un valore che indica se visualizzare il controllo Login dopo che l'utente è stato autenticato. |
Width |
Ottiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl) |
Metodi
AddAttributesToRender(HtmlTextWriter) |
Aggiunge attributi e stili HTML dei quali è necessario eseguire il rendering nell'oggetto HtmlTextWriterTag specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
AddedControl(Control, Int32) |
Chiamato dopo che un controllo figlio viene aggiunto alla raccolta 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 ControlCollection del controllo server. (Ereditato da Control) |
ApplyStyle(Style) |
Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, sovrascrivendo eventuali elementi di stile del controllo. Il metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
ApplyStyleSheetSkin(Page) |
Applica al controllo le proprietà di stile definite nel foglio di stile della pagina. (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 recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina. (Ereditato da Control) |
ClearCachedClientID() |
Imposta il valore memorizzato nella cache ClientID su |
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 proprietà ClientIDMode 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 dal quale è stato chiamato il metodo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
CreateChildControls() |
Crea i singoli controlli che costituiscono il controllo Login e associa i gestori eventi ai relativi eventi. |
CreateControlCollection() |
Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server. (Ereditato da Control) |
CreateControlStyle() |
Crea l'oggetto di stile utilizzato internamente dalla classe WebControl per implementare tutte le proprietà correlate allo stile. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
DataBind() |
Associa un'origine dati al controllo CompositeControl e a tutti i relativi controlli figlio. (Ereditato da CompositeControl) |
DataBind(Boolean) |
Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding. (Ereditato da Control) |
DataBindChildren() |
Associa un'origine dati al controllo server e ai relativi controlli figlio. (Ereditato da Control) |
Dispose() |
Abilita un controllo server alla pulizia finale prima che venga rilasciato 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, li crea. (Ereditato da Control) |
EnsureID() |
Crea un identificatore per i controlli a cui non è assegnato alcun identificatore. (Ereditato da Control) |
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
FindControl(String) |
Cerca un controllo server nel contenitore dei nomi corrente con il parametro |
FindControl(String, Int32) |
Cerca nel contenitore di denominazione corrente un controllo server con il parametro |
Focus() |
Imposta lo stato attivo per l'input su un controllo. (Ereditato da Control) |
GetDesignModeState() |
Ottiene i dati della fase di progettazione per un controllo. (Ereditato da Control) |
GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
GetRouteUrl(Object) |
Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control) |
GetRouteUrl(RouteValueDictionary) |
Ottiene l'URL corrispondente 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 a un nome della route. (Ereditato da Control) |
GetRouteUrl(String, RouteValueDictionary) |
Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control) |
GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
GetUniqueIDRelativeTo(Control) |
Restituisce la parte con prefisso della proprietà UniqueID 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 eventuali controlli figlio. (Ereditato da Control) |
IsLiteralContent() |
Determina se il controllo server conserva solo il contenuto literal. (Ereditato da Control) |
LoadControlState(Object) |
Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState(). (Ereditato da Control) |
LoadViewState(Object) |
Ripristina informazioni sullo stato della visualizzazione da una richiesta precedente salvata con il metodo SaveViewState(). |
MapPathSecure(String) |
Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo. (Ereditato da Control) |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
MergeStyle(Style) |
Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, ma non sovrascrive eventuali elementi di stile del controllo. Questo metodo viene utilizzato 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 a un livello superiore nella gerarchia dei controlli server dell'interfaccia utente per la 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 quando 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 non riesce. |
OnPreRender(EventArgs) |
Implementa il metodo OnPreRender(EventArgs) di base. |
OnUnload(EventArgs) |
Genera l'evento Unload. (Ereditato da Control) |
OpenFile(String) |
Ottiene un oggetto Stream utilizzato per leggere un file. (Ereditato da Control) |
RaiseBubbleEvent(Object, EventArgs) |
Assegna eventuali origini dell'evento e relative informazioni al controllo padre. (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 dalla raccolta Controls dell'oggetto Control. (Ereditato da Control) |
Render(HtmlTextWriter) |
Esegue il rendering del form di accesso utilizzando il writer HTML specificato. |
RenderBeginTag(HtmlTextWriter) |
Esegue il rendering del tag HTML di apertura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
RenderChildren(HtmlTextWriter) |
Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto HtmlTextWriter specificato, 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 utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
RenderControl(HtmlTextWriter) |
Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata. (Ereditato da Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato. (Ereditato da Control) |
RenderEndTag(HtmlTextWriter) |
Esegue il rendering del tag HTML di chiusura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl) |
ResolveAdapter() |
Ottiene l'adattatore del 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 formato utilizzabile dal client richiedente. (Ereditato da Control) |
SaveControlState() |
Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server. (Ereditato da Control) |
SaveViewState() |
Salva qualsiasi stato modificato dopo la chiamata del metodo TrackViewState(). |
SetDesignModeState(IDictionary) |
Imposta i dati della 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) |
Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control) |
SetTraceData(Object, Object, Object) |
Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, 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 TrackViewState() di base. |
Eventi
Authenticate |
Si verifica quando un utente viene autenticato. |
DataBinding |
Viene generato quando il controllo server viene associato a un'origine dati. (Ereditato da Control) |
Disposed |
Si verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control) |
Init |
Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata. (Ereditato da Control) |
Load |
Viene generato quando il controllo server è 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 |
Viene generato quando il controllo server viene scaricato dalla memoria. (Ereditato da Control) |
Implementazioni dell'interfaccia esplicita
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 il valore specificati. (Ereditato da WebControl) |
ICompositeControlDesignerAccessor.RecreateChildControls() |
Consente a uno strumento di progettazione di ricreare l'insieme di controlli figlio del controllo composito nell'ambiente 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
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 metatabella per il controllo contenitore dei dati. |
GetDefaultValues(INamingContainer) |
Ottiene l'insieme di valori predefiniti per il controllo dei dati specificato. |
GetMetaTable(INamingContainer) |
Ottiene i metadati della tabella per il controllo dei dati specificato. |
SetMetaTable(INamingContainer, MetaTable) |
Imposta i metadati della tabella per il controllo dei dati specificato. |
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato. |
SetMetaTable(INamingContainer, MetaTable, Object) |
Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato. |
TryGetMetaTable(INamingContainer, MetaTable) |
Determina se sono disponibili i metadati della tabella. |
EnableDynamicData(INamingContainer, Type) |
Abilita il comportamento dati dinamici per il controllo dei dati specificato. |
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Abilita il comportamento dati dinamici per il controllo dei dati specificato. |
EnableDynamicData(INamingContainer, Type, Object) |
Abilita il comportamento dati dinamici per il controllo dei dati specificato. |