Login 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供登入網站的使用者介面（UI）元素。
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- 繼承
- 屬性
範例
以下程式碼範例使用 Login 控制項來提供登入網站的介面。
<%@ 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>
以下程式碼範例示範如何擴展控制範圍 Login 。 該 CustomLogin 控制項包含 DropDownList 一個控制功能，讓使用者可以選擇他們所持有的會員服務提供者。 （這些供應商皆以 Web.config配置。）在該 OnLoggingIn 方法中，屬性 MembershipProvider 被設定為控制項的選定值 DropDownList 。
這很重要
此範例包含一個接受使用者輸入的文字框，這可能構成安全威脅。 預設情況下，ASP.NET 網頁會驗證使用者輸入中不包含腳本或 HTML 元素。 欲了解更多資訊，請參閱 腳本漏洞概述。
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
備註
本主題內容：
簡介
這個 Login 控制項是一個複合控制項，提供所有在網站上驗證使用者所需的通用介面元素。 以下三個元素是所有登入情境所必需的：
一個獨特的使用者名稱來識別使用者。
密碼用來驗證使用者身份。
一個登入按鈕，用來將登入資訊傳送到伺服器。
控制 Login 項還提供以下可選的使用者介面元素，以支援額外功能：
一個密碼提醒連結。
一個「記住我」勾選框，用於在遊戲過程中保留登入資訊。
這是一個給登入困難使用者的幫助連結。
一個「註冊新用戶」連結，可將使用者導向註冊頁面。
登入表單上的說明文字。
使用者點擊登入按鈕時會跳出自訂錯誤文字，但未填寫使用者名稱或密碼欄位。
登入失敗時會出現的自訂錯誤文字。
這是登入成功時會發生的自訂動作。
如果使用者已經登入網站，可以隱藏登入控制功能。
關於顯示哪些控制是必需的、哪些是可選的表格，請參見 LayoutTemplate 屬性。
備註
如果你不熟悉 ASP.NET 的登入控制功能，請先 ASP.NET 登入控制概覽 再繼續閱讀。 關於登入控制與會員資格的其他主題列表，請參見「 使用會員管理使用者」。
這很重要
接受用戶意見可能構成安全威脅。 惡意使用者可能會傳送旨在揭露漏洞的資料，或執行嘗試生成密碼的程式。 為了提升使用者輸入的安全性，你應該使用控制的驗證功能，並保護所有為控制設定的資料提供者。 欲了解更多資訊，請參閱 「安全登入控制」、「 網頁應用程式基本安全實務」及「 會員安全」。
該 Login 控制系統使用會員提供者來取得使用者憑證。 除非你另有說明， Login 控制項會使用 Web.config 檔案中定義的預設成員提供者。 若要指定不同的提供者，請將屬性設 MembershipProvider 為應用程式 Web.config 檔中定義的成員提供者名稱之一。 欲了解更多資訊，請參閱 會員提供者。
如果你想使用自訂的認證服務，可以用該 OnAuthenticate 方法呼叫該服務。
樣式和範本
控制鍵的外觀 Login 可透過範本和樣式設定完全自訂。 所有 UI 文字訊息也都可透過類別屬性 Login 自訂。 預設介面文字會根據伺服器的地點設定自動在地化。
如果 Login 控制項是用範本自訂的，則 AccessKey 該屬性和屬性 TabIndex 會被忽略。 此時，直接設定 AccessKey 每個範本子控制項的屬性與 TabIndex 屬性。
Login 以文字框表示的控制屬性，如 UserName 和 Password，在頁面生命週期的所有階段皆可存取。 控制項會透過文字框觸發事件，擷取終端使用者 TextChanged 所做的任何變更。
備註
如果你將 Login 控制項嵌入物件 WizardStep 中，使用者已認證時，請在事件處理程序中明確設定該 ActiveStepIndex 屬性 Page_Load 。 此情況下， Wizard 控制不會自動切換到下一個 WizardStep 物件。
下表列出 Login 控制樣式屬性，並說明每個樣式屬性影響的 UI 元素。 關於每個樣式適用於哪些屬性的清單，請參閱各樣式屬性的文件。
| 風格性質 | UI 元素受影響 |
|---|---|
| BorderPadding | 控制內容與控制區邊界之間的空間。 |
| CheckBoxStyle | 記住我。 |
| FailureTextStyle | 登入失敗文字。 |
| InstructionTextStyle | 頁面上有說明文字，告訴使用者如何使用控制項。 |
| LabelStyle | 所有輸入欄位的標籤，例如文字框。 |
| TextBoxStyle | 文字輸入欄位。 |
| TitleTextStyle | 標題文字。 |
| ValidatorTextStyle | 當登入嘗試因驗證錯誤而失敗時，會顯示給使用者的文字。 |
| HyperLinkStyle | 連結到其他頁面。 |
| LoginButtonStyle | 登入按鈕。 |
驗證分組
這些UserNamePassword屬性有RequiredFieldValidator相關控制措施，防止使用者在未提供必要資訊前提交頁面。
Login控制項使用驗證群組，使同一頁面Login上與控制項相關的其他欄位可以分別驗證。 預設情況下， ID 控制項的屬性 Login 會被用作驗證群組的名稱。 例如，ID 為「Login1」的 Login 控制項會使用驗證群組名稱「Login1」。 如果你想設定控制項所屬的驗證群組 Login ，必須先建立控制範本並更改驗證群組名稱。
應用 CSS 樣式
控制項 Login 讓你可以用標記來指定 CSS 風格的規則。 如果你用範本來自訂控制項的外觀 Login ，可以在模板的標記中指定 CSS 樣式。 此時則不需要額外的外桌。 你可以透過將屬性設定 RenderOuterTable 為 false來防止該表格被渲染。
無障礙設施
關於如何配置此控制項以產生符合無障礙標準的標記，請參閱 Visual Studio 中的無障礙，ASP.NETASP.NET 控制項與無障礙。
宣告式語法
<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>
建構函式
| 名稱 | Description |
|---|---|
| Login() |
建立一個新的控制實例 Login 。 |
欄位
| 名稱 | Description |
|---|---|
| LoginButtonCommandName |
代表與登入按鈕相關的指令名稱。 |
屬性
| 名稱 | Description |
|---|---|
| AccessKey |
取得或設定存取金鑰，讓你能快速導航到網頁伺服器控制。 (繼承來源 WebControl) |
| Adapter |
拿到瀏覽器專用的控制器轉接器。 (繼承來源 Control) |
| AppRelativeTemplateSourceDirectory |
取得或設定包含此控制項的 or UserControl 物件的Page應用程式相對虛擬目錄。 (繼承來源 Control) |
| Attributes |
取得一組任意屬性（僅用於渲染），這些屬性與控制項上的屬性不對應。 (繼承來源 WebControl) |
| BackColor |
取得或設定網頁伺服器控制項的背景色。 (繼承來源 WebControl) |
| BindingContainer |
取得包含該控制項資料綁定的控制項。 (繼承來源 Control) |
| BorderColor |
取得或設定網頁控制的邊框顏色。 (繼承來源 WebControl) |
| BorderPadding |
取得或設定控制區邊界 Login 內的填充量。 |
| BorderStyle |
取得或設定網頁伺服器控制的邊界樣式。 (繼承來源 WebControl) |
| BorderWidth |
取得或設定網頁伺服器控制的邊界寬度。 (繼承來源 WebControl) |
| CheckBoxStyle |
會得到一個物件的參考 Style ，該物件定義了「記住我」勾選框的設定。 |
| ChildControlsCreated |
會取得一個值，表示伺服器控制項的子控制項是否已被建立。 (繼承來源 Control) |
| ClientID |
取得由 ASP.NET 產生的 HTML 標記的控制 ID。 (繼承來源 Control) |
| ClientIDMode |
取得或設定用於產生屬性值 ClientID 的演算法。 (繼承來源 Control) |
| ClientIDSeparator |
會得到一個字元值，代表該屬性中使用 ClientID 的分隔符字元。 (繼承來源 Control) |
| Context |
取得 HttpContext 與伺服器控制項相關聯的物件，用於目前的網頁請求。 (繼承來源 Control) |
| Controls |
取得ControlCollection一個物件，代表子節點的控制。CompositeControl (繼承來源 CompositeControl) |
| ControlStyle |
這就有網頁伺服器控制的風格。 此特性主要由對照顯影劑使用。 (繼承來源 WebControl) |
| ControlStyleCreated |
會取得一個值，表示該屬性是否 Style 已建立 ControlStyle 物件。 此特性主要由控制顯影劑使用。 (繼承來源 WebControl) |
| CreateUserIconUrl |
取得圖片的位置，顯示在新用戶註冊頁面連結旁。 |
| CreateUserText |
取得或設定連結文字，指向新用戶的註冊頁面。 |
| CreateUserUrl |
取得或設定新用戶註冊頁面的網址。 |
| CssClass |
取得或設定由網頁伺服器控制項在用戶端渲染的層疊樣式表（CSS）類別。 (繼承來源 WebControl) |
| DataItemContainer |
如果命名容器實 IDataItemContainer作 。 (繼承來源 Control) |
| DataKeysContainer |
如果命名容器實 IDataKeysControl作 。 (繼承來源 Control) |
| DesignMode |
會獲得一個值，表示是否在設計表面上使用控制項。 (繼承來源 Control) |
| DestinationPageUrl |
當嘗試登入成功時，會取得或設定顯示給使用者的頁面網址。 |
| DisplayRememberMe |
取得或設定一個值，指示是否要顯示勾選框，讓使用者能控制是否傳送持久性 Cookie 到瀏覽器。 |
| Enabled |
取得或設定一個值，表示網頁伺服器控制是否已啟用。 (繼承來源 WebControl) |
| EnableTheming |
取得或設定一個值，指示主題是否適用於此控制。 (繼承來源 WebControl) |
| EnableViewState |
取得或設定一個值，指示伺服器控制項是否能持久化其視圖狀態，以及其包含的任何子控制項的視圖狀態，給請求端客戶端。 (繼承來源 Control) |
| Events |
會取得一個事件處理代理清單來管理控制。 這個屬性是唯讀的。 (繼承來源 Control) |
| FailureAction |
當登入嘗試失敗時，會執行或設定動作。 |
| FailureText |
當登入嘗試失敗時，會取得或設定顯示的文字。 |
| FailureTextStyle |
會獲得一組屬性的參考，這些屬性定義了控制項中 Login 錯誤文字的外觀。 |
| Font |
取得與網頁伺服器控制項相關的字型屬性。 (繼承來源 WebControl) |
| ForeColor |
取得或設定網頁伺服器控制項的前景顏色（通常是文字顏色）。 (繼承來源 WebControl) |
| HasAttributes |
會得到一個值，表示控制項是否設定了屬性。 (繼承來源 WebControl) |
| HasChildViewState |
會取得一個值，表示目前伺服器控制項的子控制項是否儲存了任何檢視狀態設定。 (繼承來源 Control) |
| Height |
取得或設定網頁伺服器控制的高度。 (繼承來源 WebControl) |
| HelpPageIconUrl |
取得圖片位置，顯示在登入說明頁面連結旁。 |
| HelpPageText |
取得或設定連結的文字，指向登入說明頁面。 |
| HelpPageUrl |
取得或設定登入說明頁面的網址。 |
| HyperLinkStyle |
會獲得一組屬性的參考，這些屬性定義了控制項中 Login 超連結的外觀。 |
| ID |
取得或設定分配給伺服器控制的程式識別碼。 (繼承來源 Control) |
| IdSeparator |
取得用來分離控制識別碼的字元。 (繼承來源 Control) |
| InstructionText |
為使用者取得或設定登入指令文字。 |
| InstructionTextStyle |
會取得一個物件的參考 TableItemStyle ，該物件定義了控制項中 Login 指令文字的設定。 |
| IsChildControlStateCleared |
會取得一個值，表示該控制中所包含的控制是否具有控制狀態。 (繼承來源 Control) |
| IsEnabled |
會得到一個值，表示該控制項是否已啟用。 (繼承來源 WebControl) |
| IsTrackingViewState |
會得到一個值，表示伺服器控制是否正在儲存對其檢視狀態的變更。 (繼承來源 Control) |
| IsViewStateEnabled |
會取得一個值，表示此控制是否啟用了檢視狀態。 (繼承來源 Control) |
| LabelStyle |
會得到一個物件的參考 TableItemStyle ，該物件定義了控制標籤的 Login 設定。 |
| LayoutTemplate |
取得或設定用來顯示控制項 Login 的範本。 |
| LoadViewStateByID |
會得到一個值，表示控制項是否參與載入其視圖狀態 ID ，而非索引。 (繼承來源 Control) |
| LoginButtonImageUrl |
取得或設定圖片的網址作為登入按鈕。 |
| LoginButtonStyle | |
| LoginButtonText |
取得或設定控制按鈕的登入按鈕文字 Login 。 |
| LoginButtonType |
在渲染 Login 按鈕時，會取得或設定按鈕的類型。 |
| MembershipProvider |
取得或設定控制中心所使用的會員資料提供者名稱。 |
| NamingContainer |
會取得伺服器控制項命名容器的參考，該容器會建立一個獨特的命名空間，用來區分具有相同 ID 屬性值的伺服器控制項。 (繼承來源 Control) |
| Orientation |
取得或設定一個值，指定控制項元素 Login 在頁面上的位置。 |
| Page |
會取得包含 Page 伺服器控制的實例參考。 (繼承來源 Control) |
| Parent |
在頁面控制階層中，會取得伺服器控制項的父控制權的參考。 (繼承來源 Control) |
| Password |
會取得使用者輸入的密碼。 |
| PasswordLabelText |
取得或設定文字框標籤 Password 的文字。 |
| PasswordRecoveryIconUrl |
它會取得圖片的位置，顯示在密碼恢復頁面的連結旁邊。 |
| PasswordRecoveryText |
取得或設定密碼恢復頁面連結的文字。 |
| PasswordRecoveryUrl |
取得或設定密碼恢復頁面的網址。 |
| PasswordRequiredErrorMessage |
當密碼欄位留空時，會接收或設定錯誤訊息在控制項 ValidationSummary 中顯示。 |
| RememberMeSet |
取得或設定一個值，指示是否要向使用者的瀏覽器傳送持久性認證 Cookie。 |
| RememberMeText |
取得或設定「記住我」選取框標籤的文字。 |
| RenderingCompatibility |
會得到一個值，指定渲染後的 HTML 會相容的 ASP.NET 版本。 (繼承來源 Control) |
| RenderOuterTable |
取得或設定一個值，指示控制器是否將渲染的 HTML 包圍在元素 |
| Site |
當在設計表面渲染時，會取得承載當前控制項的容器資訊。 (繼承來源 Control) |
| SkinID |
取得或設定皮膚貼合控制劑。 (繼承來源 WebControl) |
| Style |
會取得一組文字屬性，這些屬性會被渲染成 Web 伺服器控制項外層標籤上的樣式屬性。 (繼承來源 WebControl) |
| SupportsDisabledAttribute |
會取得一個值，指示當控制項IsEnabled屬性為 |
| TabIndex |
取得或設定網頁伺服器控制的分頁索引。 (繼承來源 WebControl) |
| TagKey |
得到 HtmlTextWriterTag 對應控制 Login 點的值。 此特性主要由對照顯影劑使用。 |
| TagName |
取得控制標籤名稱。 此特性主要由對照顯影劑使用。 (繼承來源 WebControl) |
| TemplateControl |
取得或設定包含此控制項的範本參考。 (繼承來源 Control) |
| TemplateSourceDirectory |
取得包含當前伺服器控制權的 or UserControl 虛擬目錄Page。 (繼承來源 Control) |
| TextBoxStyle |
會獲得一組定義控制項中文字框 Login 外觀的屬性的參考。 |
| TextLayout |
指定每個標籤相對於其控制項相關文字框 Login 的位置。 |
| TitleText |
取得或設定控制權的名稱 Login 。 |
| TitleTextStyle |
會獲得一組屬性的參考，這些屬性定義了控制項中 Login 標題文字的外觀。 |
| ToolTip |
當滑鼠指標懸停在網頁伺服器控制項上時，會取得或設定顯示的文字。 (繼承來源 WebControl) |
| UniqueID |
取得伺服器控制的唯一、階層限定的識別碼。 (繼承來源 Control) |
| UserName |
它會取得使用者輸入的使用者名稱。 |
| UserNameLabelText |
取得或設定文字框標籤 UserName 的文字。 |
| UserNameRequiredErrorMessage |
當使用者名稱欄位留空時，會接收或設定錯誤訊息在 ValidationSummary 控制項中顯示。 |
| ValidateRequestMode |
取得或設定一個值，指示控制器是否檢查瀏覽器的客戶端輸入是否有潛在危險的值。 (繼承來源 Control) |
| ValidatorTextStyle | |
| ViewState |
取得狀態資訊字典，讓你能儲存並還原伺服器控制的多個請求，針對同一頁面。 (繼承來源 Control) |
| ViewStateIgnoresCase |
會得到一個值，表示該物件是否 StateBag 不區分大小寫。 (繼承來源 Control) |
| ViewStateMode |
取得或設定此控制的視圖狀態模式。 (繼承來源 Control) |
| Visible |
取得或設定一個值，指示伺服器控制項是否以 UI 形式呈現在頁面上。 (繼承來源 Control) |
| VisibleWhenLoggedIn |
取得或設定一個值，指示使用者在驗證後是否要顯示控制。Login |
| Width |
取得或設定網頁伺服器控制的寬度。 (繼承來源 WebControl) |
方法
事件
| 名稱 | Description |
|---|---|
| Authenticate |
當使用者被認證時會發生。 |
| DataBinding |
當伺服器控制項綁定到資料來源時會發生。 (繼承來源 Control) |
| Disposed |
當伺服器控制從記憶體中釋放時發生，這是伺服器控制生命週期中請求 ASP.NET 頁面的最後階段。 (繼承來源 Control) |
| Init |
發生在伺服器控制初始化時，這是其生命週期的第一步。 (繼承來源 Control) |
| Load |
當伺服器控制項載入 Page 物件時會發生。 (繼承來源 Control) |
| LoggedIn |
當使用者登入網站並經過認證時，會發生這種情況。 |
| LoggingIn |
當使用者提交登入資訊，且尚未進行認證時，會發生此現象。 |
| LoginError |
當偵測到登入錯誤時會發生。 |
| PreRender |
發生在物件載入後 Control 但渲染之前。 (繼承來源 Control) |
| Unload |
當伺服器控制項從記憶體卸載時發生。 (繼承來源 Control) |
明確介面實作
擴充方法
| 名稱 | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
啟用指定資料控制的動態資料行為。 |
| EnableDynamicData(INamingContainer, Type, Object) |
啟用指定資料控制的動態資料行為。 |
| EnableDynamicData(INamingContainer, Type) |
啟用指定資料控制的動態資料行為。 |
| FindDataSourceControl(Control) |
回傳與指定控制項相關聯的資料來源。 |
| FindFieldTemplate(Control, String) |
回傳指定控制項命名容器中指定欄位的欄位範本。 |
| FindMetaTable(Control) |
回傳包含資料控制項的元值物件。 |
| GetDefaultValues(INamingContainer) |
取得指定資料控制項的預設值集合。 |
| GetMetaTable(INamingContainer) |
取得指定資料控制的表格元資料。 |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
設定指定資料控制項的表格元資料及預設值映射。 |
| SetMetaTable(INamingContainer, MetaTable, Object) |
設定指定資料控制項的表格元資料及預設值映射。 |
| SetMetaTable(INamingContainer, MetaTable) |
設定指定資料控制項的資料表元資料。 |
| TryGetMetaTable(INamingContainer, MetaTable) |
判斷表格中繼資料是否可用。 |
