Login Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje prvky uživatelského rozhraní pro přihlášení k webu.
public ref class Login : System::Web::UI::WebControls::CompositeControl[System.ComponentModel.Bindable(false)]
public class Login : System.Web.UI.WebControls.CompositeControl[<System.ComponentModel.Bindable(false)>]
type Login = class
inherit CompositeControlPublic Class Login
Inherits CompositeControl- Dědičnost
- Atributy
Příklady
Následující příklad kódu používá ovládací prvek Login k poskytnutí uživatelského rozhraní pro přihlášení k webu.
<%@ 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>
Následující příklad kódu ukazuje, jak můžete rozšířit ovládací Login prvek. Ovládací CustomLogin prvek obsahuje DropDownList ovládací prvek, který uživatelům umožňuje zvolit, pomocí kterého zprostředkovatele členství budou ověřeni. (Tito poskytovatelé jsou nakonfigurovaní v Web.config.) OnLoggingIn V metodě MembershipProvider je vlastnost nastavena na vybranou hodnotu DropDownList ovládacího prvku.
Důležité
Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.
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
Poznámky
V tomto tématu:
Úvod
Ovládací Login prvek je složený ovládací prvek, který poskytuje všechny společné prvky uživatelského rozhraní potřebné k ověření uživatele na webu. Pro všechny scénáře přihlášení jsou vyžadovány následující tři prvky:
Jedinečné uživatelské jméno pro identifikaci uživatele.
Heslo pro ověření identity uživatele.
Přihlašovací tlačítko pro odeslání přihlašovacích údajů na server.
Ovládací Login prvek také poskytuje následující volitelné prvky uživatelského rozhraní, které podporují další funkce:
Odkaz na připomenutí hesla.
Zaškrtávací políčko Pamatovat si mě pro uchování přihlašovacích údajů mezi relacemi
Odkaz Nápověda pro uživatele, kteří mají potíže s přihlášením.
Odkaz Zaregistrovat nového uživatele, který přesměruje uživatele na registrační stránku.
Text instrukce, který se zobrazí v přihlašovacím formuláři.
Vlastní text chyby, který se zobrazí, když uživatel klikne na tlačítko pro přihlášení bez vyplnění polí uživatelského jména nebo hesla.
Vlastní text chyby, který se zobrazí, pokud se přihlášení nezdaří.
Vlastní akce, ke které dojde při úspěšném přihlášení.
Způsob, jak skrýt ovládací prvek přihlášení, pokud je uživatel již přihlášen k webu.
Tabulku znázorňující, které ovládací prvky jsou povinné a které volitelné, najdete v tématu LayoutTemplate vlastnost.
Poznámka
Pokud nejste obeznámeni se sadou ovládacích prvků přihlášení, které jsou k dispozici v ASP.NET, přečtěte si před pokračováním přehled ASP.NET přihlašovacích ovládacích prvků . Seznam dalších témat souvisejících s ovládacími prvky přihlášení a členstvím najdete v tématu Správa uživatelů pomocí členství.
Důležité
Přijetí vstupu uživatele je potenciální bezpečnostní hrozbou. Uživatelé se zlými úmysly můžou odesílat data, která mají odhalit ohrožení zabezpečení, nebo spouštět programy, které se pokusí vygenerovat hesla. Pokud chcete zlepšit zabezpečení při práci s uživatelským vstupem, měli byste použít ověřovací funkce vašeho ovládacího prvku a zabezpečit všechny poskytovatele dat, kteří jsou nakonfigurovaní pro vaše řízení. Další informace najdete v tématech Zabezpečení ovládacích prvků přihlášení, Základní postupy zabezpečení pro webové aplikace a Zabezpečení členství.
Ovládací Login prvek používá poskytovatele členství k získání přihlašovacích údajů uživatele. Pokud nezadáte jinak, Login použije ovládací prvek výchozího zprostředkovatele členství definovaného v souboru Web.config. Pokud chcete zadat jiného zprostředkovatele, nastavte MembershipProvider vlastnost na jeden z názvů zprostředkovatelů členství definovaných v souboru Web.config vaší aplikace. Další informace najdete v tématu Poskytovatelé členství.
Pokud chcete použít vlastní ověřovací službu, můžete k volání služby použít metodu OnAuthenticate .
– styly a šablony
Vzhled Login ovládacího prvku je plně přizpůsobitelný prostřednictvím šablon a nastavení stylu. Všechny textové zprávy uživatelského rozhraní jsou také přizpůsobitelné prostřednictvím vlastností Login třídy. Výchozí text rozhraní se automaticky lokalizuje na základě nastavení národního prostředí na serveru.
Login Pokud je ovládací prvek přizpůsobený pomocí šablon, AccessKey vlastnost a TabIndex vlastnost jsou ignorovány. V tomto případě nastavte AccessKey vlastnost a TabIndex vlastnost každého podřízeného ovládacího prvku šablony přímo.
Login Vlastnosti ovládacích prvků reprezentované textovými poli, jako UserName jsou a Password, jsou přístupné ve všech fázích životního cyklu stránky. Ovládací prvek provede všechny změny provedené koncovým uživatelem prostřednictvím TextChanged události aktivované textovými poli.
Poznámka
Pokud vložíte ovládací prvek do Login objektu WizardStep , explicitně nastavte ActiveStepIndex vlastnost v obslužné rutině Page_Load události, pokud je uživatel ověřený. Ovládací Wizard prvek automaticky nepřevádí na další WizardStep objekt v tomto scénáři.
Následující tabulka uvádí Login vlastnosti stylu ovládacího prvku a vysvětluje, na který prvek uživatelského rozhraní má každá vlastnost stylu vliv. Seznam vlastností, na které se jednotlivé styly vztahují, najdete v dokumentaci k jednotlivým vlastnostem stylu.
| Vlastnost Style | Ovlivněný prvek uživatelského rozhraní |
|---|---|
| BorderPadding | Mezera mezi obsahem ovládacího prvku a ohraničením ovládacího prvku |
| CheckBoxStyle | Zaškrtávací políčko Pamatovat si mě. |
| FailureTextStyle | Text o chybě přihlášení |
| InstructionTextStyle | Instruktážní text na stránce, který uživatelům říká, jak používat ovládací prvek. |
| LabelStyle | Popisky pro všechna vstupní pole, například textová pole. |
| TextBoxStyle | Vstupní pole pro zadávání textu. |
| TitleTextStyle | Text nadpisu. |
| ValidatorTextStyle | Text zobrazený uživateli v případě neúspěšného pokusu o přihlášení kvůli chybám ověření |
| HyperLinkStyle | Odkazy na jiné stránky. |
| LoginButtonStyle | Tlačítko Přihlásit se. |
Ověřovací seskupení
Vlastnosti UserName a Password mají RequiredFieldValidator přidružené ovládací prvky, které uživatelům brání v odeslání stránky bez poskytnutí požadovaných informací.
Ovládací Login prvek používá ověřovací skupinu, aby ostatní pole na stejné stránce jako ovládací Login prvek bylo možné ověřit samostatně. Ve výchozím nastavení se ID vlastnost Login ovládacího prvku používá jako název ověřovací skupiny. Například Login ovládací prvek s ID "Login1" bude používat název ověřovací skupiny "Login1". Pokud chcete nastavit ověřovací skupinu, do které Login je ovládací prvek součástí, musíte vytvořit šablonu ovládacího prvku a změnit název ověřovací skupiny.
Aplikování stylů CSS
Ovládací Login prvek umožňuje určit pravidla stylu CSS ve značkách. Pokud používáte šablony k přizpůsobení vzhledu Login ovládacího prvku, můžete zadat styly CSS v značkách v šablonách. V takovém případě není vyžadována žádná další vnější tabulka. Vykreslení tabulky můžete zabránit nastavením RenderOuterTable vlastnosti na false.
Usnadnění
Informace o konfiguraci tohoto ovládacího prvku tak, aby vygeneroval značky, které odpovídají standardům přístupnosti, najdete v tématech Přístupnost v sadě Visual Studio a ASP.NET a ASP.NET Ovládací prvky a přístupnost.
Deklarativní syntaxe
<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>
Konstruktory
| Login() |
Vytvoří novou instanci Login ovládacího prvku. |
Pole
| LoginButtonCommandName |
Představuje název příkazu přidruženého k přihlašovacímu tlačítku. |
Vlastnosti
| AccessKey |
Získá nebo nastaví přístupový klíč, který umožňuje rychle přejít na ovládací prvek webového serveru. (Zděděno od WebControl) |
| Adapter |
Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control) |
| AppRelativeTemplateSourceDirectory |
Získá nebo nastaví aplikace relativní virtuální adresář nebo UserControl objektuPage, který obsahuje tento ovládací prvek. (Zděděno od Control) |
| Attributes |
Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku. (Zděděno od WebControl) |
| BackColor |
Získá nebo nastaví barvu pozadí ovládacího prvku webového serveru. (Zděděno od WebControl) |
| BindingContainer |
Získá ovládací prvek, který obsahuje datové vazby tohoto ovládacího prvku. (Zděděno od Control) |
| BorderColor |
Získá nebo nastaví barvu ohraničení webového ovládacího prvku. (Zděděno od WebControl) |
| BorderPadding |
Získá nebo nastaví velikost odsazení uvnitř ohraničení Login ovládacího prvku. |
| BorderStyle |
Získá nebo nastaví styl ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl) |
| BorderWidth |
Získá nebo nastaví šířku ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl) |
| CheckBoxStyle |
Získá odkaz na Style objekt, který definuje nastavení pro zaškrtávací políčko Zapamatovat. |
| ChildControlsCreated |
Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClientID |
Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET. (Zděděno od Control) |
| ClientIDMode |
Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti. (Zděděno od Control) |
| ClientIDSeparator |
Získá hodnotu znaku představující znak oddělovače použitý ve ClientID vlastnosti. (Zděděno od Control) |
| Context |
HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control) |
| Controls |
ControlCollection Získá objekt, který představuje podřízené ovládací prvky v objektu CompositeControl. (Zděděno od CompositeControl) |
| ControlStyle |
Získá styl ovládacího prvku webového serveru. Tuto vlastnost používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| ControlStyleCreated |
Získá hodnotu označující, zda Style objekt byl vytvořen pro ControlStyle vlastnost. Tuto vlastnost primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl) |
| CreateUserIconUrl |
Získá umístění obrázku, který se zobrazí vedle odkazu na registrační stránku pro nové uživatele. |
| CreateUserText |
Získá nebo nastaví text odkazu na registrační stránku pro nové uživatele. |
| CreateUserUrl |
Získá nebo nastaví adresu URL stránky registrace nového uživatele. |
| CssClass |
Získá nebo nastaví css (CSS) třídy vykreslované webový server ovládací prvek v klientovi. (Zděděno od WebControl) |
| DataItemContainer |
Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer. (Zděděno od Control) |
| DataKeysContainer |
Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl. (Zděděno od Control) |
| DesignMode |
Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše. (Zděděno od Control) |
| DestinationPageUrl |
Získá nebo nastaví adresu URL stránky zobrazené uživateli při úspěšném pokusu o přihlášení. |
| DisplayRememberMe |
Získá nebo nastaví hodnotu označující, zda se má zobrazit zaškrtávací políčko umožňující uživateli řídit, zda je trvalý soubor cookie odeslán do prohlížeče. |
| Enabled |
Získá nebo nastaví hodnotu označující, zda je povolený ovládací prvek webového serveru. (Zděděno od WebControl) |
| EnableTheming |
Získá nebo nastaví hodnotu označující, zda motivy použít pro tento ovládací prvek. (Zděděno od WebControl) |
| EnableViewState |
Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, pro žádajícího klienta. (Zděděno od Control) |
| Events |
Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control) |
| FailureAction |
Získá nebo nastaví akci, ke které dojde při pokusu o přihlášení se nezdaří. |
| FailureText |
Získá nebo nastaví text zobrazený při pokusu o přihlášení se nezdaří. |
| FailureTextStyle |
Získá odkaz na kolekci vlastností, které definují vzhled textu chyby v ovládacím Login prvku. |
| Font |
Získá vlastnosti písma přidružené k ovládacímu prvku webového serveru. (Zděděno od WebControl) |
| ForeColor |
Získá nebo nastaví barvu popředí (obvykle barvu textu) ovládacího prvku webového serveru. (Zděděno od WebControl) |
| HasAttributes |
Získá hodnotu označující, zda ovládací prvek má nastaveny atributy. (Zděděno od WebControl) |
| HasChildViewState |
Získá hodnotu označující, zda podřízené ovládací prvky aktuálního serveru mají uložené nastavení stavu zobrazení. (Zděděno od Control) |
| Height |
Získá nebo nastaví výšku ovládacího prvku webového serveru. (Zděděno od WebControl) |
| HelpPageIconUrl |
Získá umístění obrázku, který se zobrazí vedle odkazu na stránku nápovědy přihlášení. |
| HelpPageText |
Získá nebo nastaví text odkazu na stránku nápovědy pro přihlášení. |
| HelpPageUrl |
Získá nebo nastaví adresu URL přihlašovací stránky nápovědy. |
| HyperLinkStyle |
Získá odkaz na kolekci vlastností, které definují vzhled hypertextových odkazů v ovládacím Login prvku. |
| ID |
Získá nebo nastaví programový identifikátor přiřazený k ovládacímu prvku serveru. (Zděděno od Control) |
| IdSeparator |
Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control) |
| InstructionText |
Získá nebo nastaví text instrukce přihlášení pro uživatele. |
| InstructionTextStyle |
Získá odkaz na TableItemStyle objekt, který definuje nastavení pro instrukční text v ovládacím Login prvku. |
| IsChildControlStateCleared |
Získá hodnotu označující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav řízení. (Zděděno od Control) |
| IsEnabled |
Získá hodnotu označující, zda je ovládací prvek povolen. (Zděděno od WebControl) |
| IsTrackingViewState |
Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení. (Zděděno od Control) |
| IsViewStateEnabled |
Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control) |
| LabelStyle |
Získá odkaz na TableItemStyle objekt, který definuje nastavení popisků Login ovládacích prvků. |
| LayoutTemplate |
Získá nebo nastaví šablonu použitou Login k zobrazení ovládacího prvku. |
| LoadViewStateByID |
Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu ID zobrazení místo indexu. (Zděděno od Control) |
| LoginButtonImageUrl |
Získá nebo nastaví adresu URL obrázku, který se má použít pro tlačítko přihlášení. |
| LoginButtonStyle |
Získá odkaz na Style objekt, který umožňuje nastavit vzhled přihlašovací tlačítko v ovládacím prvku Login . |
| LoginButtonText |
Získá nebo nastaví text pro Login tlačítko pro přihlášení ovládacího prvku. |
| LoginButtonType |
Získá nebo nastaví typ tlačítka použít při vykreslování Login tlačítka. |
| MembershipProvider |
Získá nebo nastaví název zprostředkovatele dat členství používané ovládací prvek. |
| NamingContainer |
Získá odkaz na názvový kontejner ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro rozdíl mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control) |
| Orientation |
Získá nebo nastaví hodnotu, která určuje pozici prvků Login ovládacího prvku na stránce. |
| Page |
Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control) |
| Parent |
Získá odkaz na serverový ovládací prvek nadřazený ovládací prvek v hierarchii ovládacích prvků stránky. (Zděděno od Control) |
| Password |
Získá heslo zadané uživatelem. |
| PasswordLabelText |
Získá nebo nastaví text popisku textového Password pole. |
| PasswordRecoveryIconUrl |
Získá umístění obrázku, který se zobrazí vedle odkazu na stránku pro obnovení hesla. |
| PasswordRecoveryText |
Získá nebo nastaví text odkazu na stránku obnovení hesla. |
| PasswordRecoveryUrl |
Získá nebo nastaví adresu URL stránky pro obnovení hesla. |
| PasswordRequiredErrorMessage |
Získá nebo nastaví chybovou zprávu, která se zobrazí v ovládacím ValidationSummary prvku, když pole hesla zůstane prázdné. |
| RememberMeSet |
Získá nebo nastaví hodnotu označující, zda se má odeslat trvalý ověřovací soubor cookie do prohlížeče uživatele. |
| RememberMeText |
Získá nebo nastaví text popisku pro zaškrtávací políčko Pamatovat si mě. |
| RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verze, která vykreslí HTML bude kompatibilní s. (Zděděno od Control) |
| RenderOuterTable |
Získá nebo nastaví hodnotu, která označuje, zda ovládací prvek obklopuje vykreslené HTML v elementu |
| Site |
Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše. (Zděděno od Control) |
| SkinID |
Získá nebo nastaví kůži na ovládací prvek. (Zděděno od WebControl) |
| Style |
Získá kolekci text atributů, které budou vykresleny jako atribut stylu na vnější značku webového serveru ovládacího prvku. (Zděděno od WebControl) |
| SupportsDisabledAttribute |
Získá hodnotu, která označuje, zda má ovládací prvek nastavit |
| TabIndex |
Získá nebo nastaví index tabulátoru ovládacího prvku webového serveru. (Zděděno od WebControl) |
| TagKey |
HtmlTextWriterTag Získá hodnotu, která odpovídá ovládacímu prvkuLogin. Tuto vlastnost používají primárně vývojáři ovládacích prvků. |
| TagName |
Získá název značky ovládacího prvku. Tuto vlastnost používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| TemplateControl |
Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control) |
| TemplateSourceDirectory |
Získá virtuální adresář Page nebo UserControl , který obsahuje aktuální serverový ovládací prvek. (Zděděno od Control) |
| TextBoxStyle |
Získá odkaz na kolekci vlastností, které definují vzhled textových polí v ovládacím Login prvku. |
| TextLayout |
Určuje umístění každého popisku vzhledem k přidruženému textovému Login poli ovládacího prvku. |
| TitleText |
Získá nebo nastaví název Login ovládacího prvku. |
| TitleTextStyle |
Získá odkaz na kolekci vlastností, které definují vzhled textu nadpisu v ovládacím prvku Login . |
| ToolTip |
Získá nebo nastaví text zobrazený, když ukazatel myši najede na ovládací prvek webového serveru. (Zděděno od WebControl) |
| UniqueID |
Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku. (Zděděno od Control) |
| UserName |
Získá uživatelské jméno zadané uživatelem. |
| UserNameLabelText |
Získá nebo nastaví text popisku textového UserName pole. |
| UserNameRequiredErrorMessage |
Získá nebo nastaví chybovou zprávu, která se zobrazí v ovládacím prvku ValidationSummary , když pole uživatelského jména zůstane prázdné. |
| ValidateRequestMode |
Získá nebo nastaví hodnotu, která označuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control) |
| ValidatorTextStyle |
Získá odkaz na kolekci Style vlastností, které definují vzhled chybových zpráv spojených s validátory používanými ovládacím prvku Login . |
| ViewState |
Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení serverového ovládacího prvku napříč více požadavky na stejnou stránku. (Zděděno od Control) |
| ViewStateIgnoresCase |
Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control) |
| ViewStateMode |
Získá nebo nastaví režim zobrazení stavu tohoto ovládacího prvku. (Zděděno od Control) |
| Visible |
Získá nebo nastaví hodnotu, která označuje, zda je serverový ovládací prvek vykreslen jako uživatelské rozhraní na stránce. (Zděděno od Control) |
| VisibleWhenLoggedIn |
Získá nebo nastaví hodnotu označující, zda se má ovládací prvek zobrazit Login po ověření uživatele. |
| Width |
Získá nebo nastaví šířku ovládacího prvku webového serveru. (Zděděno od WebControl) |
Metody
| AddAttributesToRender(HtmlTextWriter) |
Přidá atributy a styly HTML, které je potřeba vykreslit do zadaného HtmlTextWriterTag. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| AddedControl(Control, Int32) |
Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control) |
| AddParsedSubObject(Object) |
Upozorní ovládací prvek serveru, že byl analyzován prvek XML nebo HTML, a přidá element do objektu ovládacího prvku ControlCollection serveru. (Zděděno od Control) |
| ApplyStyle(Style) |
Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku a přepíše všechny existující prvky stylu ovládacího prvku. Tuto metodu primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl) |
| ApplyStyleSheetSkin(Page) |
Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control) |
| BeginRenderTracing(TextWriter, Object) |
Zahájí trasování vykreslování dat v době návrhu. (Zděděno od Control) |
| BuildProfileTree(String, Boolean) |
Shromáždí informace o ovládacím prvku serveru a doručí je do Trace vlastnosti, která se má zobrazit, když je pro stránku povolené trasování. (Zděděno od Control) |
| ClearCachedClientID() |
Nastaví hodnotu v ClientID mezipaměti na |
| ClearChildControlState() |
Odstraní informace o stavu řízení pro podřízené ovládací prvky serveru. (Zděděno od Control) |
| ClearChildState() |
Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control) |
| ClearChildViewState() |
Odstraní informace o stavu zobrazení všech podřízených ovládacích prvků serveru. (Zděděno od Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control) |
| CopyBaseAttributes(WebControl) |
Zkopíruje vlastnosti, které nejsou zapouzdřeny objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je volána tato metoda. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| CreateChildControls() |
Vytvoří jednotlivé ovládací prvky, které tvoří Login ovládací prvek, a přidruží obslužné rutiny událostí k jejich událostem. |
| CreateControlCollection() |
Vytvoří nový ControlCollection objekt, který bude obsahovat podřízené ovládací prvky (literál i server) serverového ovládacího prvku. (Zděděno od Control) |
| CreateControlStyle() |
Vytvoří objekt stylu, který se interně používá třídy k implementaci všech vlastností souvisejících se stylem WebControl . Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| DataBind() |
Vytvoří vazbu zdroje dat na CompositeControl a všechny jeho podřízené ovládací prvky. (Zděděno od CompositeControl) |
| DataBind(Boolean) |
Vytvoří vazbu zdroje dat na vyvoláný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control) |
| DataBindChildren() |
Sváže zdroj dat s podřízenými ovládacími prvky serverového ovládacího prvku. (Zděděno od Control) |
| Dispose() |
Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control) |
| EndRenderTracing(TextWriter, Object) |
Ukončí trasování vykreslovaných dat v době návrhu. (Zděděno od Control) |
| EnsureChildControls() |
Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control) |
| EnsureID() |
Vytvoří identifikátor ovládacích prvků, které nemají přiřazený identifikátor. (Zděděno od Control) |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| FindControl(String) |
Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek pomocí zadaného |
| FindControl(String, Int32) |
Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným |
| Focus() |
Nastaví fokus vstupu na ovládací prvek. (Zděděno od Control) |
| GetDesignModeState() |
Získá data v době návrhu pro ovládací prvek. (Zděděno od Control) |
| GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
| GetRouteUrl(Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
| GetRouteUrl(RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control) |
| GetRouteUrl(String, Object) |
Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control) |
| GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
| GetUniqueIDRelativeTo(Control) |
Vrátí předponu vlastnosti UniqueID zadaného ovládacího prvku. (Zděděno od Control) |
| HasControls() |
Určuje, jestli serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky. (Zděděno od Control) |
| HasEvents() |
Vrátí hodnotu označující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control) |
| IsLiteralContent() |
Určuje, jestli serverový ovládací prvek obsahuje pouze obsah literálu. (Zděděno od Control) |
| LoadControlState(Object) |
Obnoví informace o stavu řízení z předchozího požadavku stránky, který byl uložen metodou SaveControlState() . (Zděděno od Control) |
| LoadViewState(Object) |
Obnoví informace o stavu zobrazení z předchozího požadavku, který byl uložen s metodou SaveViewState() . |
| MapPathSecure(String) |
Načte fyzickou cestu, na kterou se mapuje virtuální cesta, absolutní nebo relativní. (Zděděno od Control) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| MergeStyle(Style) |
Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku, ale nepřepíše žádné existující prvky stylu ovládacího prvku. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| OnAuthenticate(AuthenticateEventArgs) |
Authenticate Vyvolá událost k ověření uživatele. |
| OnBubbleEvent(Object, EventArgs) |
Určuje, zda se má událost předat hierarchii serveru uživatelského rozhraní (UI) stránky. |
| OnDataBinding(EventArgs) |
DataBinding Vyvolá událost. (Zděděno od Control) |
| OnInit(EventArgs) |
Init Vyvolá událost. (Zděděno od Control) |
| OnLoad(EventArgs) |
Load Vyvolá událost. (Zděděno od Control) |
| OnLoggedIn(EventArgs) |
LoggedIn Vyvolá událost po přihlášení uživatele k webu a byl ověřen. |
| OnLoggingIn(LoginCancelEventArgs) |
Vyvolá událost, LoggingIn když uživatel odešle přihlašovací údaje, ale před provedením ověřování. |
| OnLoginError(EventArgs) |
Vyvolá událost, LoginError když se nezdaří pokus o přihlášení. |
| OnPreRender(EventArgs) |
Implementuje základní OnPreRender(EventArgs) metodu. |
| OnUnload(EventArgs) |
Unload Vyvolá událost. (Zděděno od Control) |
| OpenFile(String) |
Stream Získá zvyk ke čtení souboru. (Zděděno od Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Přiřadí všechny zdroje události a její informace nadřazené ovládacímu prvku. (Zděděno od Control) |
| RecreateChildControls() |
Znovu vytvoří podřízené ovládací prvky v ovládacím prvku odvozeného z CompositeControl. (Zděděno od CompositeControl) |
| RemovedControl(Control) |
Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control) |
| Render(HtmlTextWriter) |
Vykreslí přihlašovací formulář pomocí zadaného zapisovače HTML. |
| RenderBeginTag(HtmlTextWriter) |
Vykreslí levou značku HTML ovládacího prvku určenému zapisovači. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| RenderChildren(HtmlTextWriter) |
Vypíše obsah podřízených položek serverového ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control) |
| RenderContents(HtmlTextWriter) |
Vykreslí obsah ovládacího prvku určenému zapisovači. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| RenderControl(HtmlTextWriter) |
Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povolené. (Zděděno od Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (Zděděno od Control) |
| RenderEndTag(HtmlTextWriter) |
Vykreslí koncovou značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| ResolveAdapter() |
Získá řídicí adaptér zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control) |
| ResolveClientUrl(String) |
Získá adresu URL, kterou lze použít v prohlížeči. (Zděděno od Control) |
| ResolveUrl(String) |
Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi. (Zděděno od Control) |
| SaveControlState() |
Uloží všechny změny stavu ovládacího prvku serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Control) |
| SaveViewState() |
Uloží všechny stavy, které byly změněny po vyvolání TrackViewState() metody. |
| SetDesignModeState(IDictionary) |
Nastaví data v době návrhu ovládacího prvku. |
| SetRenderMethodDelegate(RenderMethod) |
Přiřadí delegáta obslužné rutiny události, který vykresluje serverový ovládací prvek a jeho obsah do nadřazeného ovládacího prvku. (Zděděno od Control) |
| SetTraceData(Object, Object) |
Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
| SetTraceData(Object, Object, Object) |
Nastaví trasovací data pro trasování vykreslování dat v době návrhu pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| TrackViewState() |
Přepíše základní TrackViewState() metodu. |
Událost
| Authenticate |
Vyvolá se při ověření uživatele. |
| DataBinding |
Nastane, když ovládací prvek serveru vytvoří vazbu na zdroj dat. (Zděděno od Control) |
| Disposed |
Nastane při uvolnění serverového ovládacího prvku z paměti, což je poslední fáze životního cyklu řízení serveru, když je požadována stránka ASP.NET. (Zděděno od Control) |
| Init |
Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control) |
| Load |
Nastane při načtení serverového ovládacího prvku do objektu Page . (Zděděno od Control) |
| LoggedIn |
Vyvolá se, když se uživatel přihlásí k webu a byl ověřen. |
| LoggingIn |
Vyvolá se, když uživatel před provedením ověření odešle přihlašovací údaje. |
| LoginError |
Vyvolá se při zjištění chyby přihlášení. |
| PreRender |
Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control) |
| Unload |
Vyvolá se při uvolnění serverového ovládacího prvku z paměti. (Zděděno od Control) |
Explicitní implementace rozhraní
Metody rozšíření
| FindDataSourceControl(Control) |
Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek. |
| FindFieldTemplate(Control, String) |
Vrátí šablonu pole pro zadaný sloupec v kontejneru názvů zadaného ovládacího prvku. |
| FindMetaTable(Control) |
Vrátí objekt metatable pro ovládací prvek obsahující data. |
| GetDefaultValues(INamingContainer) |
Získá kolekci výchozích hodnot pro zadaný datový ovládací prvek. |
| GetMetaTable(INamingContainer) |
Získá metadata tabulky pro zadaný datový ovládací prvek. |
| SetMetaTable(INamingContainer, MetaTable) |
Nastaví metadata tabulky pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Nastaví metadata tabulky a mapování výchozích hodnot pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Nastaví metadata tabulky a mapování výchozích hodnot pro zadaný ovládací prvek dat. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Určuje, jestli jsou k dispozici metadata tabulky. |
| EnableDynamicData(INamingContainer, Type) |
Umožňuje dynamické chování dat pro zadaný datový ovládací prvek. |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Umožňuje dynamické chování dat pro zadaný datový ovládací prvek. |
| EnableDynamicData(INamingContainer, Type, Object) |
Umožňuje dynamické chování dat pro zadaný datový ovládací prvek. |
Platí pro
Viz také
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro