HtmlInputPassword 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
允許以程式設計方式存取伺服器上的 HTML <input type= password> 項目。
public ref class HtmlInputPassword : System::Web::UI::HtmlControls::HtmlInputText[System.Web.UI.ValidationProperty("Value")]
public class HtmlInputPassword : System.Web.UI.HtmlControls.HtmlInputText[<System.Web.UI.ValidationProperty("Value")>]
type HtmlInputPassword = class
inherit HtmlInputText
interface IPostBackDataHandlerPublic Class HtmlInputPassword
Inherits HtmlInputText- 繼承
- 屬性
- 實作
範例
下列程式碼範例示範如何在 Web Form 頁面上以宣告方式使用 <input type=text> 、 <input type=password> 和 <input type=submit> HTML 控制項。
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<p></p><div>Username</div> <br />
<input type="text" runat="server" />
<p></p><div>Password</div> <br />
<input type="password" runat="server" />
<p></p><input type="submit" runat="server" value="Submit" />
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<p></p><div>Username</div> <br />
<input type="text" runat="server" />
<p></p><div>Password</div> <br />
<input type="password" runat="server" />
<p></p><input type="submit" runat="server" value="Submit" />
</form>
</body>
</html>
下列程式碼範例示範如何在呼叫 Page_Load 方法期間以程式設計方式新增相同的 HTML 控制項。
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void page_load(object sender, EventArgs e)
{
if (IsPostBack)
{
// Add code to process the Login.
}
}
protected void Page_Init(object sender, EventArgs e)
{
HtmlInputText userText = new HtmlInputText();
userText.MaxLength = 20;
Placeholder1.Controls.Add(userText);
HtmlInputPassword passwordText = new HtmlInputPassword();
passwordText.MaxLength = 20;
Placeholder2.Controls.Add(passwordText);
HtmlInputSubmit submitButton = new HtmlInputSubmit();
submitButton.Value = "Submit";
Placeholder3.Controls.Add(submitButton);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<table cellpadding="2">
<tr>
<td>User Name
<asp:placeholder
runat="server"
id="Placeholder1" />
</td></tr>
<tr>
<td>Password
<asp:placeholder
runat="server"
id="Placeholder2" />
</td></tr>
<tr><td><asp:placeholder
runat="server"
id="Placeholder3" />
</td></tr>
</table>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
If (IsPostBack) Then
' Add code to process the Login.
End If
End Sub
Protected Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs)
Dim userText As HtmlInputText = New HtmlInputText
userText.MaxLength = 20
Placeholder1.Controls.Add(userText)
Dim passwordText As HtmlInputPassword = New HtmlInputPassword
passwordText.MaxLength = 20
Placeholder2.Controls.Add(passwordText)
Dim submitButton As HtmlInputSubmit = New HtmlInputSubmit
submitButton.Value = "Submit"
Placeholder3.Controls.Add(submitButton)
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">
<table cellpadding="2">
<tr>
<td>User Name
<asp:placeholder
runat="server"
id="Placeholder1" />
</td></tr>
<tr>
<td>Password
<asp:placeholder
runat="server"
id="Placeholder2" />
</td></tr>
<tr><td><asp:placeholder
runat="server"
id="Placeholder3" />
</td></tr>
</table>
</form>
</body>
</html>
備註
類別 HtmlInputPassword 衍生自 類別， HtmlInputText 可用來建立單行文字方塊，讓使用者輸入密碼。 使用 HtmlInputPassword 控制項時， Value 屬性會在每次提交表單時張貼到伺服器。 Value控制項的 HtmlInputPassword 屬性不會保存在檢視狀態中。
屬性 MaxLength 會指定可以在文字方塊中輸入的最大字元數。 屬性 Size 可讓您指定文字方塊的寬度。 Value使用 屬性來判斷使用者在文字方塊中輸入的值。 HtmlInputPassword控制項提供 ServerChange 事件，當屬性變更貼文到伺服器之間的值時 Value ，就會引發此事件。 這可讓您建立事件處理常式，以在每次引發事件時執行一組自訂指令。
注意
控制項 HtmlInputPassword 不提供回傳至伺服器的內建方式。 您必須在網頁上提供另一個控制項，以支援回傳至伺服器，例如 HtmlButton 或 HtmlInputSubmit 控制項。
如需 實例 HtmlInputPassword 的初始屬性值清單，請參閱 建 HtmlInputPassword 構函式。
建構函式
| HtmlInputPassword() |
使用預設值，初始化 HtmlInputPassword 類別的新執行個體。 |
屬性
| Adapter |
針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control) |
| AppRelativeTemplateSourceDirectory |
取得或設定包含了此控制項之 Page 或 UserControl 物件的相對應用程式虛擬目錄。 (繼承來源 Control) |
| Attributes |
取得 ASP.NET 網頁內伺服器控制項標記上所表示，所有成對屬性名稱和值的集合。 (繼承來源 HtmlControl) |
| BindingContainer |
取得包含了此控制項之資料繫結的控制項。 (繼承來源 Control) |
| ChildControlsCreated |
取得值，指出是否已經建立伺服器控制項的子控制項。 (繼承來源 Control) |
| ClientID |
取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。 (繼承來源 Control) |
| ClientIDMode |
取得或設定用來產生 ClientID 屬性值的演算法。 (繼承來源 Control) |
| ClientIDSeparator |
取得字元值，表示在 ClientID 屬性中所使用的分隔字元。 (繼承來源 Control) |
| Context |
取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。 (繼承來源 Control) |
| Controls |
取得 ControlCollection 物件，表示 UI 階層架構中指定之伺服器控制項的子控制項。 (繼承來源 Control) |
| DataItemContainer |
如果命名容器實作 IDataItemContainer，則取得命名容器的參考。 (繼承來源 Control) |
| DataKeysContainer |
如果命名容器實作 IDataKeysControl，則取得命名容器的參考。 (繼承來源 Control) |
| DesignMode |
取得值，指出控制項是否正用於設計介面上。 (繼承來源 Control) |
| Disabled |
取得或設定值，指出是否停用 HTML 伺服器控制項。 (繼承來源 HtmlControl) |
| EnableTheming |
取得或設定值，指出佈景主題是否套用至此控制項。 (繼承來源 Control) |
| EnableViewState |
取得或設定值，該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態，以及它包含的任何子控制項狀態。 (繼承來源 Control) |
| Events |
取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。 (繼承來源 Control) |
| HasChildViewState |
取得值，指出目前伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。 (繼承來源 Control) |
| ID |
取得或設定指派給伺服器控制項的程式設計識別項。 (繼承來源 Control) |
| IdSeparator |
取得用來分隔控制項識別項的字元。 (繼承來源 Control) |
| IsChildControlStateCleared |
取得值，指出這個控制項中所包含的控制項是否有控制項狀態。 (繼承來源 Control) |
| IsTrackingViewState |
取得值，指出伺服器控制項是否正在儲存檢視狀態的變更。 (繼承來源 Control) |
| IsViewStateEnabled |
取得值，指出這個控制項是否已啟用檢視狀態。 (繼承來源 Control) |
| LoadViewStateByID |
取得值，指出控制項是否依 ID (而不是索引) 參與載入其檢視狀態。 (繼承來源 Control) |
| MaxLength |
取得或設定可輸入文字方塊的最大字元數。 (繼承來源 HtmlInputText) |
| Name |
取得或設定 HtmlInputControl 控制項的唯一識別項名稱。 (繼承來源 HtmlInputControl) |
| NamingContainer |
取得伺服器控制項命名容器的參考，其建立唯一命名空間，在具有相同 ID 屬性值的伺服器控制項之間作區別。 (繼承來源 Control) |
| Page |
取得含有伺服器控制項的 Page 執行個體的參考。 (繼承來源 Control) |
| Parent |
在網頁控制階層架構中取得伺服器控制項之父控制項的參考。 (繼承來源 Control) |
| RenderingCompatibility |
取得值，這個值會指定將與呈現 HTML 相容的 ASP.NET 版本。 (繼承來源 Control) |
| Site |
當呈現在設計介面上時，取得裝載目前控制項之容器的資訊。 (繼承來源 Control) |
| Size |
取得或設定文字方塊的寬度。 (繼承來源 HtmlInputText) |
| SkinID |
取得或設定要套用至控制項的面板。 (繼承來源 Control) |
| Style |
取得在 ASP.NET 檔案中套用到指定 HTML 伺服器控制項的所有階層式樣式表 (CSS) 屬性集合。 (繼承來源 HtmlControl) |
| TagName |
取得標記項目名稱，其包含 |
| TemplateControl |
取得或設定包含了此控制項之樣板的參考。 (繼承來源 Control) |
| TemplateSourceDirectory |
取得包含目前伺服器控制項的 Page 或 UserControl 的虛擬目錄。 (繼承來源 Control) |
| Type |
取得 HtmlInputControl 的型別。 (繼承來源 HtmlInputControl) |
| UniqueID |
取得伺服器控制項唯一的、符合階層架構的識別項。 (繼承來源 Control) |
| ValidateRequestMode |
取得或設定值，指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。 (繼承來源 Control) |
| Value |
取得或設定文字方塊的內容。 (繼承來源 HtmlInputText) |
| ViewState |
取得狀態資訊的字典，允許您在相同網頁的多個要求之間，儲存和還原伺服器控制項的檢視狀態。 (繼承來源 Control) |
| ViewStateIgnoresCase |
取得值，指出 HtmlControl 檢視狀態是否區分大小寫。 (繼承來源 HtmlControl) |
| ViewStateMode |
取得或設定這個控制項的檢視狀態模式。 (繼承來源 Control) |
| Visible |
取得或設定值，指出伺服器控制項是否會轉譯為頁面上的 UI。 (繼承來源 Control) |
方法
事件
| DataBinding |
發生於伺服器控制項繫結至資料來源時。 (繼承來源 Control) |
| Disposed |
發生於伺服器控制項從記憶體釋放時，這是在要求 ASP.NET 網頁時，伺服器控制項生命週期的最後階段。 (繼承來源 Control) |
| Init |
發生於初始化伺服器控制項時，是其生命週期中的第一個步驟。 (繼承來源 Control) |
| Load |
發生於載入伺服器控制項至 Page 物件時。 (繼承來源 Control) |
| PreRender |
在 Control 物件載入之後但在呈現之前發生。 (繼承來源 Control) |
| ServerChange |
發生於 Value 屬性在伺服器上變更時。 (繼承來源 HtmlInputText) |
| Unload |
發生於伺服器控制項從記憶體卸載時。 (繼承來源 Control) |
明確介面實作
擴充方法
| FindDataSourceControl(Control) |
傳回與指定之控制項的資料控制項相關聯的資料來源。 |
| FindFieldTemplate(Control, String) |
傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。 |
| FindMetaTable(Control) |
傳回包含資料控制項的中繼資料表物件。 |
