Login Klass

Definition

Namnområde:: System.Web.UI.WebControls

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Tillhandahåller användargränssnittselement (UI) för att logga in på en webbplats.

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

Arv: Object

Control

WebControl

CompositeControl
Login

Attribut: BindableAttribute

Exempel

I följande kodexempel används en Login kontroll för att tillhandahålla ett användargränssnitt för att logga in på en webbplats.

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

Följande kodexempel visar hur du kan utöka Login kontrollen. Kontrollen CustomLogin innehåller en DropDownList kontroll som låter användarna välja vilken medlemskapsprovider de autentiseras med. (Dessa leverantörer konfigureras i Web.config.) OnLoggingIn I -metoden MembershipProvider anges egenskapen till det valda värdet för DropDownList kontrollen.

Important

Det här exemplet innehåller en textruta som accepterar användarindata, vilket är ett potentiellt säkerhetshot. Som standard kontrollerar ASP.NET webbsidor att användarindata inte innehåller skript- eller HTML-element. Mer information finns i Översikt över skriptexploateringar.

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

Kommentarer

I det här avsnittet:

Inledning
Formatmallar och mallar
Valideringsgruppering
Tillgänglighet
Använda CSS-formatmallar
Deklarativ syntax

Introduction

Kontrollen Login är en sammansatt kontroll som innehåller alla vanliga gränssnittselement som behövs för att autentisera en användare på en webbplats. Följande tre element krävs för alla inloggningsscenarier:

Ett unikt användarnamn för att identifiera användaren.
Ett lösenord för att verifiera användarens identitet.
En inloggningsknapp för att skicka inloggningsinformationen till servern.

Kontrollen Login innehåller också följande valfria gränssnittselement som stöder ytterligare funktioner:

En länk för en lösenordspåminnelse.
Kryssrutan Kom ihåg mig för att behålla inloggningsinformationen mellan sessioner.
En hjälplänk för användare som har problem med att logga in.
En registrera ny användare-länk som omdirigerar användare till en registreringssida.
Instruktionstext som visas i inloggningsformuläret.
Anpassad feltext som visas när användaren klickar på inloggningsknappen utan att fylla i fälten användarnamn eller lösenord.
Anpassad feltext som visas om inloggningen misslyckas.
En anpassad åtgärd som inträffar när inloggningen lyckas.
Ett sätt att dölja inloggningskontrollen om användaren redan är inloggad på webbplatsen.

En tabell som visar vilka kontroller som krävs och vilka som är valfria finns i LayoutTemplate egenskapen .

Note

Om du inte är bekant med den uppsättning inloggningskontroller som är tillgängliga i ASP.NET kan du läsa ASP.NET Översikt över inloggningskontroller innan du fortsätter. En lista över andra ämnen som rör inloggningskontroller och medlemskap finns i Hantera användare med hjälp av medlemskap.

Important

Att acceptera användarindata är ett potentiellt säkerhetshot. Skadliga användare kan skicka data som är avsedda att exponera sårbarheter eller köra program som försöker generera lösenord. För att förbättra säkerheten när du arbetar med användarindata bör du använda valideringsfunktionerna för din kontroll och skydda alla dataprovidrar som har konfigurerats för din kontroll. Mer information finns i Skydda inloggningskontroller, grundläggande säkerhetsmetoder för webbprogram och skydda medlemskap.

Kontrollen Login använder en medlemskapsprovider för att hämta användarautentiseringsuppgifter. Om du inte anger något annat Login använder kontrollen standardmedlemskapsprovidern som definierats i filen Web.config. Om du vill ange en annan provider anger du MembershipProvider egenskapen till ett av medlemskapsprovidernamnen som definierats i programmets Web.config-fil. Mer information finns i Medlemskapsproviders.

Om du vill använda en anpassad autentiseringstjänst kan du använda OnAuthenticate metoden för att anropa tjänsten.

Format och mallar

Kontrollens Login utseende är helt anpassningsbart via mallar och formatinställningar. Alla textmeddelanden i användargränssnittet kan också anpassas via klassens Login egenskaper. Standardgränssnittstexten lokaliseras automatiskt baserat på språkinställningen på servern.

Om kontrollen Login är anpassad med mallar ignoreras AccessKey egenskapen och TabIndex egenskapen. I det här fallet anger du AccessKey egenskapen och egenskapen för varje underordnad TabIndex mallkontroll direkt.

Login kontrollegenskaper som representeras av textrutor, till exempel UserName och Password, är tillgängliga under alla faser i sidlivscykeln. Kontrollen hämtar alla ändringar som slutanvändaren har gjort med hjälp av den TextChanged händelse som utlöses av textrutorna.

Note

Om du bäddar in Login kontrollen i ett WizardStep objekt anger du uttryckligen ActiveStepIndex egenskapen i en Page_Load händelsehanterare om användaren autentiseras. Kontrollen Wizard går inte automatiskt vidare till nästa WizardStep objekt i det här scenariot.

I följande tabell visas egenskaperna för Login kontrollformat och förklarar vilket gränssnittselement varje formategenskap påverkar. En lista över vilka egenskaper varje formatmall gäller för finns i dokumentationen för de enskilda formategenskaperna.

Formategenskap	Användargränssnittselement påverkas
BorderPadding	Utrymmet mellan kontrollinnehållet och kontrollens kantlinje.
CheckBoxStyle	Kryssrutan Kom ihåg mig.
FailureTextStyle	Text om inloggningsfel.
InstructionTextStyle	Instruktionstext på sidan som talar om för användarna hur de ska använda kontrollen.
LabelStyle	Etiketter för alla indatafält, till exempel textrutor.
TextBoxStyle	Textinmatningsindatafält.
TitleTextStyle	Rubriktext.
ValidatorTextStyle	Text som visas för användaren när ett inloggningsförsök misslyckas på grund av valideringsfel.
HyperLinkStyle	Länkar till andra sidor.
LoginButtonStyle	Inloggningsknapp.

Valideringsgruppering

Egenskaperna UserName och Password har RequiredFieldValidator kontroller som är associerade med dem för att förhindra användare från att skicka sidan utan att ange nödvändig information.

Kontrollen Login använder en valideringsgrupp så att andra fält på samma sida som Login kontrollen kan verifieras separat. Som standard ID används kontrollens Login egenskap som namnet på verifieringsgruppen. Till exempel använder en Login kontroll med ID:t "Login1" ett verifieringsgruppnamn för "Login1". Om du vill ange den verifieringsgrupp som kontrollen ingår i Login måste du malla kontrollen och ändra verifieringsgruppens namn.

Använda CSS-formatmallar

Med Login kontrollen kan du ange CSS-formatregler i markering. Om du använder mallar för att anpassa kontrollens Login utseende kan du ange CSS-formatmallar i markeringarna i mallarna. I så fall krävs ingen extra yttre tabell. Du kan förhindra att tabellen återges genom att ange RenderOuterTable egenskapen till false.

Tillgänglighet

Information om hur du konfigurerar den här kontrollen så att den genererar markering som överensstämmer med tillgänglighetsstandarder finns i Accessibility i Visual Studio och ASP.NET och ASP.NET Controls and Accessibility.

Deklarativ syntax

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

Konstruktorer

Name	Description
Login()	Skapar en ny instans av Login kontrollen.

Fält

Name	Description
LoginButtonCommandName	Representerar kommandonamnet som är associerat med inloggningsknappen.

Egenskaper

Name	Description
AccessKey	Hämtar eller anger åtkomstnyckeln som gör att du snabbt kan navigera till webbserverkontrollen. (Ärvd från WebControl)
Adapter	Hämtar det webbläsarspecifika adaptern för kontrollen. (Ärvd från Control)
AppRelativeTemplateSourceDirectory	Hämtar eller anger den programrelativa virtuella katalogen Page UserControl för eller -objektet som innehåller den här kontrollen. (Ärvd från Control)
Attributes	Hämtar samlingen med godtyckliga attribut (endast för återgivning) som inte motsvarar egenskaperna i kontrollen. (Ärvd från WebControl)
BackColor	Hämtar eller anger bakgrundsfärgen för webbserverkontrollen. (Ärvd från WebControl)
BindingContainer	Hämtar kontrollen som innehåller den här kontrollens databindning. (Ärvd från Control)
BorderColor	Hämtar eller anger kantlinjefärgen för webbkontrollen. (Ärvd från WebControl)
BorderPadding	Hämtar eller anger mängden utfyllnad inuti kontrollens Login kantlinjer.
BorderStyle	Hämtar eller anger kantlinjeformatet för webbserverkontrollen. (Ärvd från WebControl)
BorderWidth	Hämtar eller anger kantlinjebredden för webbserverkontrollen. (Ärvd från WebControl)
CheckBoxStyle	Hämtar en referens till ett Style objekt som definierar inställningarna för kryssrutan Kom ihåg mig.
ChildControlsCreated	Hämtar ett värde som anger om serverkontrollens underordnade kontroller har skapats. (Ärvd från Control)
ClientID	Hämtar kontroll-ID:t för HTML-kod som genereras av ASP.NET. (Ärvd från Control)
ClientIDMode	Hämtar eller anger den algoritm som används för att generera värdet för ClientID egenskapen. (Ärvd från Control)
ClientIDSeparator	Hämtar ett teckenvärde som representerar det avgränsartecken som används i egenskapen ClientID . (Ärvd från Control)
Context	Hämtar objektet HttpContext som är associerat med serverkontrollen för den aktuella webbbegäran. (Ärvd från Control)
Controls	Hämtar ett ControlCollection objekt som representerar de underordnade kontrollerna i en CompositeControl. (Ärvd från CompositeControl)
ControlStyle	Hämtar formatmallen för webbserverkontrollen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
ControlStyleCreated	Hämtar ett värde som anger om ett Style objekt har skapats för egenskapen ControlStyle . Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
CreateUserIconUrl	Hämtar platsen för en bild som ska visas bredvid länken till en registreringssida för nya användare.
CreateUserText	Hämtar eller anger texten i en länk till en registreringssida för nya användare.
CreateUserUrl	Hämtar eller anger URL:en för registreringssidan för den nya användaren.
CssClass	Hämtar eller anger css-klassen (Cascading Style Sheet) som återges av webbserverkontrollen på klienten. (Ärvd från WebControl)
DataItemContainer	Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataItemContainer. (Ärvd från Control)
DataKeysContainer	Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataKeysControl. (Ärvd från Control)
DesignMode	Hämtar ett värde som anger om en kontroll används på en designyta. (Ärvd från Control)
DestinationPageUrl	Hämtar eller anger url:en för sidan som visas för användaren när ett inloggningsförsök lyckas.
DisplayRememberMe	Hämtar eller anger ett värde som anger om en kryssruta ska visas så att användaren kan kontrollera om en beständig cookie skickas till webbläsaren.
Enabled	Hämtar eller anger ett värde som anger om webbserverkontrollen är aktiverad. (Ärvd från WebControl)
EnableTheming	Hämtar eller anger ett värde som anger om teman ska gälla för den här kontrollen. (Ärvd från WebControl)
EnableViewState	Hämtar eller anger ett värde som anger om serverkontrollen bevarar sitt visningstillstånd och visningstillståndet för eventuella underordnade kontroller som den innehåller till den begärande klienten. (Ärvd från Control)
Events	Hämtar en lista över händelsehanterardelegater för kontrollen. Den här egenskapen är skrivskyddad. (Ärvd från Control)
FailureAction	Hämtar eller anger den åtgärd som inträffar när ett inloggningsförsök misslyckas.
FailureText	Hämtar eller anger texten som visas när ett inloggningsförsök misslyckas.
FailureTextStyle	Hämtar en referens till en samling egenskaper som definierar utseendet på feltexten Login i kontrollen.
Font	Hämtar teckensnittsegenskaperna som är associerade med webbserverkontrollen. (Ärvd från WebControl)
ForeColor	Hämtar eller anger förgrundsfärgen (vanligtvis textens färg) för webbserverkontrollen. (Ärvd från WebControl)
HasAttributes	Hämtar ett värde som anger om kontrollen har attribut inställda. (Ärvd från WebControl)
HasChildViewState	Hämtar ett värde som anger om den aktuella serverkontrollens underordnade kontroller har några sparade vytillståndsinställningar. (Ärvd från Control)
Height	Hämtar eller anger höjden på webbserverkontrollen. (Ärvd från WebControl)
HelpPageIconUrl	Hämtar platsen för en bild som ska visas bredvid länken till inloggningshjälpsidan.
HelpPageText	Hämtar eller anger texten i en länk till inloggningshjälpsidan.
HelpPageUrl	Hämtar eller anger URL:en för inloggningshjälpsidan.
HyperLinkStyle	Hämtar en referens till en samling egenskaper som definierar utseendet på hyperlänkar i Login kontrollen.
ID	Hämtar eller anger den programmatiska identifierare som tilldelats serverkontrollen. (Ärvd från Control)
IdSeparator	Hämtar det tecken som används för att separera kontrollidentifierare. (Ärvd från Control)
InstructionText	Hämtar eller anger inloggningsinstruktionstext för användaren.
InstructionTextStyle	Hämtar en referens till ett TableItemStyle objekt som definierar inställningarna för instruktionstext i Login kontrollen.
IsChildControlStateCleared	Hämtar ett värde som anger om kontroller i den här kontrollen har kontrolltillstånd. (Ärvd från Control)
IsEnabled	Hämtar ett värde som anger om kontrollen är aktiverad. (Ärvd från WebControl)
IsTrackingViewState	Hämtar ett värde som anger om serverkontrollen sparar ändringar i visningstillståndet. (Ärvd från Control)
IsViewStateEnabled	Hämtar ett värde som anger om visningstillstånd är aktiverat för den här kontrollen. (Ärvd från Control)
LabelStyle	Hämtar en referens till ett TableItemStyle objekt som definierar inställningarna för Login kontrolletiketter.
LayoutTemplate	Hämtar eller anger den mall som används för att visa Login kontrollen.
LoadViewStateByID	Hämtar ett värde som anger om kontrollen deltar i inläsningen av dess visningstillstånd i ID stället för index. (Ärvd från Control)
LoginButtonImageUrl	Hämtar eller anger url:en för en bild som ska användas för inloggningsknappen.
LoginButtonStyle	Hämtar en referens till objektet Style som gör att du kan ange utseendet på inloggningsknappen i Login kontrollen.
LoginButtonText	Hämtar eller anger texten för Login kontrollens inloggningsknapp.
LoginButtonType	Hämtar eller anger vilken typ av knapp som ska användas när knappen återges Login .
MembershipProvider	Hämtar eller anger namnet på den medlemskapsdataprovider som används av kontrollen.
NamingContainer	Hämtar en referens till serverkontrollens namngivningscontainer, vilket skapar ett unikt namnområde för differentiering mellan serverkontroller med samma ID egenskapsvärde. (Ärvd från Control)
Orientation	Hämtar eller anger ett värde som anger positionen för elementen i Login kontrollen på sidan.
Page	Hämtar en referens till den Page instans som innehåller serverkontrollen. (Ärvd från Control)
Parent	Hämtar en referens till serverkontrollens överordnade kontroll i sidkontrollhierarkin. (Ärvd från Control)
Password	Hämtar lösenordet som angetts av användaren.
PasswordLabelText	Hämtar eller anger texten i etiketten för Password textrutan.
PasswordRecoveryIconUrl	Hämtar platsen för en bild som ska visas bredvid länken till sidan för lösenordsåterställning.
PasswordRecoveryText	Hämtar eller anger texten i en länk till sidan för lösenordsåterställning.
PasswordRecoveryUrl	Hämtar eller anger URL:en för sidan för lösenordsåterställning.
PasswordRequiredErrorMessage	Hämtar eller anger felmeddelandet som ska visas i en ValidationSummary kontroll när lösenordsfältet lämnas tomt.
RememberMeSet	Hämtar eller anger ett värde som anger om en beständig autentiseringscookie ska skickas till användarens webbläsare.
RememberMeText	Hämtar eller anger texten i etiketten för kryssrutan Kom ihåg mig.
RenderingCompatibility	Hämtar ett värde som anger den ASP.NET version som renderad HTML kommer att vara kompatibel med. (Ärvd från Control)
RenderOuterTable	Hämtar eller anger ett värde som anger om kontrollen omsluter renderad HTML i ett `table` element för att tillämpa infogade formatmallar.
Site	Hämtar information om containern som är värd för den aktuella kontrollen när den återges på en designyta. (Ärvd från Control)
SkinID	Hämtar eller ställer in huden för att applicera på kontrollen. (Ärvd från WebControl)
Style	Hämtar en samling textattribut som återges som ett formatattribut på den yttre taggen för webbserverkontrollen. (Ärvd från WebControl)
SupportsDisabledAttribute	Hämtar ett värde som anger om kontrollen ska ange `disabled` attributet för det renderade HTML-elementet till "inaktiverat" när kontrollens IsEnabled egenskap är `false`. (Ärvd från CompositeControl)
TabIndex	Hämtar eller anger flikindexet för webbserverkontrollen. (Ärvd från WebControl)
TagKey	Hämtar värdet HtmlTextWriterTag som motsvarar en Login kontroll. Den här egenskapen används främst av kontrollutvecklare.
TagName	Hämtar namnet på kontrolltaggen. Den här egenskapen används främst av kontrollutvecklare. (Ärvd från WebControl)
TemplateControl	Hämtar eller anger en referens till mallen som innehåller den här kontrollen. (Ärvd från Control)
TemplateSourceDirectory	Hämtar den virtuella katalogen för Page eller UserControl som innehåller den aktuella serverkontrollen. (Ärvd från Control)
TextBoxStyle	Hämtar en referens till en samling egenskaper som definierar utseendet på textrutor i Login kontrollen.
TextLayout	Anger positionen för varje etikett i förhållande till dess associerade textruta för Login kontrollen.
TitleText	Hämtar eller anger kontrollens Login rubrik.
TitleTextStyle	Hämtar en referens till en samling egenskaper som definierar utseendet på rubriktexten Login i kontrollen.
ToolTip	Hämtar eller anger texten som visas när muspekaren hovrar över webbserverkontrollen. (Ärvd från WebControl)
UniqueID	Hämtar den unika, hierarkiskt kvalificerade identifieraren för serverkontrollen. (Ärvd från Control)
UserName	Hämtar användarnamnet som angetts av användaren.
UserNameLabelText	Hämtar eller anger texten i etiketten för UserName textrutan.
UserNameRequiredErrorMessage	Hämtar eller anger felmeddelandet som ska visas i en ValidationSummary kontroll när användarnamnsfältet lämnas tomt.
ValidateRequestMode	Hämtar eller anger ett värde som anger om kontrollen kontrollerar klientindata från webbläsaren efter potentiellt farliga värden. (Ärvd från Control)
ValidatorTextStyle	Hämtar en referens till en samling Style egenskaper som definierar utseendet på felmeddelanden som är associerade med validatorer som används av Login kontrollen.
ViewState	Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för en serverkontroll över flera begäranden för samma sida. (Ärvd från Control)
ViewStateIgnoresCase	Hämtar ett värde som anger om objektet StateBag är skiftlägesokänsligt. (Ärvd från Control)
ViewStateMode	Hämtar eller anger visningstillståndsläget för den här kontrollen. (Ärvd från Control)
Visible	Hämtar eller anger ett värde som anger om en serverkontroll återges som användargränssnitt på sidan. (Ärvd från Control)
VisibleWhenLoggedIn	Hämtar eller anger ett värde som anger om kontrollen ska visas Login när användaren har autentiserats.
Width	Hämtar eller anger bredden på webbserverkontrollen. (Ärvd från WebControl)

Metoder

Name	Description
AddAttributesToRender(HtmlTextWriter)	Lägger till HTML-attribut och formatmallar som måste återges till den angivna HtmlTextWriterTag. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
AddedControl(Control, Int32)	Anropas efter att en underordnad kontroll har lagts till i Controls Control objektets samling. (Ärvd från Control)
AddParsedSubObject(Object)	Meddelar serverkontrollen att ett element, antingen XML eller HTML, parsades och lägger till elementet i serverkontrollens ControlCollection objekt. (Ärvd från Control)
ApplyStyle(Style)	Kopierar alla icke-tomma element i det angivna formatet till webbkontrollen och skriver över alla befintliga formatelement i kontrollen. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
ApplyStyleSheetSkin(Page)	Tillämpar formategenskaperna som definierats i sidformatmallen på kontrollen. (Ärvd från Control)
BeginRenderTracing(TextWriter, Object)	Påbörjar designtidsspårning av återgivningsdata. (Ärvd från Control)
BuildProfileTree(String, Boolean)	Samlar in information om serverkontrollen och levererar den till egenskapen Trace som ska visas när spårning är aktiverat för sidan. (Ärvd från Control)
ClearCachedClientID()	Anger det cachelagrade ClientID värdet till `null`. (Ärvd från Control)
ClearChildControlState()	Tar bort kontrolltillståndsinformationen för serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearChildState()	Tar bort informationen om visningstillstånd och kontrolltillstånd för alla serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearChildViewState()	Tar bort visningstillståndsinformationen för alla serverkontrollens underordnade kontroller. (Ärvd från Control)
ClearEffectiveClientIDMode()	Anger egenskapen för ClientIDMode den aktuella kontrollinstansen och för eventuella underordnade kontroller till Inherit. (Ärvd från Control)
CopyBaseAttributes(WebControl)	Kopierar egenskaperna som inte kapslas in av Style objektet från den angivna webbserverkontrollen till den webbserverkontroll som den här metoden anropas från. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
CreateChildControls()	Skapar de enskilda kontroller som utgör Login kontrollen och associerar händelsehanterare med deras händelser.
CreateControlCollection()	Skapar ett nytt ControlCollection objekt som innehåller de underordnade kontrollerna (både literal och server) för serverkontrollen. (Ärvd från Control)
CreateControlStyle()	Skapar formatobjektet som används internt av WebControl klassen för att implementera alla formatrelaterade egenskaper. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
DataBind()	Binder en datakälla till CompositeControl och alla dess underordnade kontroller. (Ärvd från CompositeControl)
DataBind(Boolean)	Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller med ett alternativ för att skapa händelsen DataBinding . (Ärvd från Control)
DataBindChildren()	Binder en datakälla till serverkontrollens underordnade kontroller. (Ärvd från Control)
Dispose()	Gör att en serverkontroll kan utföra slutlig rensning innan den frigörs från minnet. (Ärvd från Control)
EndRenderTracing(TextWriter, Object)	Avslutar designtidsspårning av återgivningsdata. (Ärvd från Control)
EnsureChildControls()	Avgör om serverkontrollen innehåller underordnade kontroller. Om den inte gör det skapar den underordnade kontroller. (Ärvd från Control)
EnsureID()	Skapar en identifierare för kontroller som inte har tilldelats någon identifierare. (Ärvd från Control)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
FindControl(String, Int32)	Söker i den aktuella namngivningscontainern efter en serverkontroll med det angivna `id` och ett heltal som anges i parametern `pathOffset` , vilket underlättar sökningen. Du bör inte åsidosätta den här versionen av FindControl metoden. (Ärvd från Control)
FindControl(String)	Söker i den aktuella namngivningscontainern efter en serverkontroll med den angivna `id` parametern. (Ärvd från Control)
Focus()	Anger indatafokus till en kontroll. (Ärvd från Control)
GetDesignModeState()	Hämtar designtidsdata för en kontroll. (Ärvd från Control)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetRouteUrl(Object)	Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control)
GetRouteUrl(RouteValueDictionary)	Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control)
GetRouteUrl(String, Object)	Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control)
GetRouteUrl(String, RouteValueDictionary)	Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
GetUniqueIDRelativeTo(Control)	Returnerar den prefixade delen av UniqueID egenskapen för den angivna kontrollen. (Ärvd från Control)
HasControls()	Avgör om serverkontrollen innehåller några underordnade kontroller. (Ärvd från Control)
HasEvents()	Returnerar ett värde som anger om händelser har registrerats för kontrollen eller underordnade kontroller. (Ärvd från Control)
IsLiteralContent()	Avgör om serverkontrollen endast innehåller literalinnehåll. (Ärvd från Control)
LoadControlState(Object)	Återställer kontrolltillståndsinformation från en begäran från föregående sida som sparades av SaveControlState() metoden. (Ärvd från Control)
LoadViewState(Object)	Återställer visningstillståndsinformation från en tidigare begäran som sparades med SaveViewState() metoden.
MapPathSecure(String)	Hämtar den fysiska sökväg som en virtuell sökväg, antingen absolut eller relativ, mappar till. (Ärvd från Control)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
MergeStyle(Style)	Kopierar alla icke-tomma element i det angivna formatet till webbkontrollen, men skriver inte över några befintliga formatelement i kontrollen. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
OnAuthenticate(AuthenticateEventArgs)	Genererar Authenticate händelsen för att autentisera användaren.
OnBubbleEvent(Object, EventArgs)	Avgör om en händelse ska skickas uppåt på sidans användargränssnittsserverkontrollhierarki.
OnDataBinding(EventArgs)	Genererar händelsen DataBinding . (Ärvd från Control)
OnInit(EventArgs)	Genererar händelsen Init . (Ärvd från Control)
OnLoad(EventArgs)	Genererar händelsen Load . (Ärvd från Control)
OnLoggedIn(EventArgs)	Genererar LoggedIn händelsen när användaren loggar in på webbplatsen och har autentiserats.
OnLoggingIn(LoginCancelEventArgs)	Genererar LoggingIn händelsen när en användare skickar inloggningsinformation men innan autentiseringen äger rum.
OnLoginError(EventArgs)	Genererar LoginError händelsen när ett inloggningsförsök misslyckas.
OnPreRender(EventArgs)	Implementerar basmetoden OnPreRender(EventArgs) .
OnUnload(EventArgs)	Genererar händelsen Unload . (Ärvd från Control)
OpenFile(String)	Hämtar en Stream som används för att läsa en fil. (Ärvd från Control)
RaiseBubbleEvent(Object, EventArgs)	Tilldelar alla källor till händelsen och dess information till kontrollens överordnade. (Ärvd från Control)
RecreateChildControls()	Återskapar de underordnade kontrollerna i en kontroll som härleds från CompositeControl. (Ärvd från CompositeControl)
RemovedControl(Control)	Anropas efter att en underordnad Controls kontroll har tagits bort från objektets Control samling. (Ärvd från Control)
Render(HtmlTextWriter)	Renderar inloggningsformuläret med den angivna HTML-skrivaren.
RenderBeginTag(HtmlTextWriter)	Renderar HTML-öppningstaggen för kontrollen till den angivna skrivaren. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
RenderChildren(HtmlTextWriter)	Matar ut innehållet i en serverkontrolls underordnade objekt till ett angivet HtmlTextWriter objekt som skriver innehållet som ska återges på klienten. (Ärvd från Control)
RenderContents(HtmlTextWriter)	Renderar innehållet i kontrollen till den angivna skrivaren. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt med hjälp av ett angivet ControlAdapter objekt. (Ärvd från Control)
RenderControl(HtmlTextWriter)	Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt och lagrar spårningsinformation om kontrollen om spårning är aktiverat. (Ärvd från Control)
RenderEndTag(HtmlTextWriter)	Renderar HTML-avslutande taggen för kontrollen till den angivna skrivaren. Den här metoden används främst av kontrollutvecklare. (Ärvd från WebControl)
ResolveAdapter()	Hämtar kontrollkortet som ansvarar för att återge den angivna kontrollen. (Ärvd från Control)
ResolveClientUrl(String)	Hämtar en URL som kan användas av webbläsaren. (Ärvd från Control)
ResolveUrl(String)	Konverterar en URL till en som kan användas på den begärande klienten. (Ärvd från Control)
SaveControlState()	Sparar alla ändringar i serverkontrolltillståndet som har inträffat sedan sidan publicerades tillbaka till servern. (Ärvd från Control)
SaveViewState()	Sparar alla tillstånd som ändrades efter TrackViewState() att metoden anropades.
SetDesignModeState(IDictionary)	Anger designtidsdata för en kontroll.
SetRenderMethodDelegate(RenderMethod)	Tilldelar ett händelsehanterardelegat för att återge serverkontrollen och dess innehåll till den överordnade kontrollen. (Ärvd från Control)
SetTraceData(Object, Object, Object)	Anger spårningsdata för designtidsspårning av återgivningsdata, med hjälp av det spårade objektet, spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control)
SetTraceData(Object, Object)	Anger spårningsdata för designtidsspårning av återgivningsdata med hjälp av spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)
TrackViewState()	Åsidosätter basmetoden TrackViewState() .

Händelser

Name	Description
Authenticate	Inträffar när en användare autentiseras.
DataBinding	Inträffar när serverkontrollen binder till en datakälla. (Ärvd från Control)
Disposed	Inträffar när en serverkontroll frigörs från minnet, vilket är den sista fasen i serverkontrolllivscykeln när en ASP.NET sida begärs. (Ärvd från Control)
Init	Inträffar när serverkontrollen initieras, vilket är det första steget i dess livscykel. (Ärvd från Control)
Load	Inträffar när serverkontrollen läses in i Page objektet. (Ärvd från Control)
LoggedIn	Inträffar när användaren loggar in på webbplatsen och har autentiserats.
LoggingIn	Inträffar när en användare skickar inloggningsinformation innan autentiseringen äger rum.
LoginError	Inträffar när ett inloggningsfel identifieras.
PreRender	Inträffar efter att objektet Control har lästs in men före återgivningen. (Ärvd från Control)
Unload	Inträffar när serverkontrollen tas bort från minnet. (Ärvd från Control)

Explicita gränssnittsimplementeringar

Name	Description
IAttributeAccessor.GetAttribute(String)	Hämtar ett attribut för webbkontrollen med det angivna namnet. (Ärvd från WebControl)
IAttributeAccessor.SetAttribute(String, String)	Anger ett attribut för webbkontrollen till det angivna namnet och värdet. (Ärvd från WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Gör att en designer kan återskapa den sammansatta kontrollens samling underordnade kontroller i designmiljön. (Ärvd från CompositeControl)
IControlBuilderAccessor.ControlBuilder	En beskrivning av den här medlemmen finns i ControlBuilder. (Ärvd från Control)
IControlDesignerAccessor.GetDesignModeState()	En beskrivning av den här medlemmen finns i GetDesignModeState(). (Ärvd från Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	En beskrivning av den här medlemmen finns i SetDesignModeState(IDictionary). (Ärvd från Control)
IControlDesignerAccessor.SetOwnerControl(Control)	En beskrivning av den här medlemmen finns i SetOwnerControl(Control). (Ärvd från Control)
IControlDesignerAccessor.UserData	En beskrivning av den här medlemmen finns i UserData. (Ärvd från Control)
IDataBindingsAccessor.DataBindings	En beskrivning av den här medlemmen finns i DataBindings. (Ärvd från Control)
IDataBindingsAccessor.HasDataBindings	En beskrivning av den här medlemmen finns i HasDataBindings. (Ärvd från Control)
IExpressionsAccessor.Expressions	En beskrivning av den här medlemmen finns i Expressions. (Ärvd från Control)
IExpressionsAccessor.HasExpressions	En beskrivning av den här medlemmen finns i HasExpressions. (Ärvd från Control)
IParserAccessor.AddParsedSubObject(Object)	En beskrivning av den här medlemmen finns i AddParsedSubObject(Object). (Ärvd från Control)

Tilläggsmetoder

Name	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Aktiverar dynamiskt databeteende för den angivna datakontrollen.
EnableDynamicData(INamingContainer, Type, Object)	Aktiverar dynamiskt databeteende för den angivna datakontrollen.
EnableDynamicData(INamingContainer, Type)	Aktiverar dynamiskt databeteende för den angivna datakontrollen.
FindDataSourceControl(Control)	Returnerar datakällan som är associerad med datakontrollen för den angivna kontrollen.
FindFieldTemplate(Control, String)	Returnerar fältmallen för den angivna kolumnen i den angivna kontrollens namngivningscontainer.
FindMetaTable(Control)	Returnerar metatabellobjektet för den innehållande datakontrollen.
GetDefaultValues(INamingContainer)	Hämtar insamlingen av standardvärdena för den angivna datakontrollen.
GetMetaTable(INamingContainer)	Hämtar tabellmetadata för den angivna datakontrollen.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Anger tabellmetadata och standardvärdemappning för den angivna datakontrollen.
SetMetaTable(INamingContainer, MetaTable, Object)	Anger tabellmetadata och standardvärdemappning för den angivna datakontrollen.
SetMetaTable(INamingContainer, MetaTable)	Anger tabellmetadata för den angivna datakontrollen.
TryGetMetaTable(INamingContainer, MetaTable)	Avgör om tabellmetadata är tillgängliga.

Gäller för

Se även

Feedback

Var den här sidan till hjälp?