共用方式為


PasswordRecovery 類別

定義

提供使用者介面 (UI) 項目,讓使用者復原或重設遺失的密碼,並在電子郵件中接收密碼。

public ref class PasswordRecovery : System::Web::UI::WebControls::CompositeControl
[System.ComponentModel.Bindable(false)]
public class PasswordRecovery : System.Web.UI.WebControls.CompositeControl
[<System.ComponentModel.Bindable(false)>]
type PasswordRecovery = class
    inherit CompositeControl
Public Class PasswordRecovery
Inherits CompositeControl
繼承
屬性

範例

下列程式代碼範例示範如何使用 PasswordRecovery 控件。

<%@ 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">
    
    // Set the field label background color if the user name is not found.
    void PasswordRecovery1_UserLookupError(object sender, System.EventArgs e)
    {
        PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Red;
    }
    
    // Reset the field label background color.
    void PasswordRecovery1_Load(object sender, System.EventArgs e)
    {
        PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Black;
    }
</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:PasswordRecovery id="PasswordRecovery1" runat="server" BorderStyle="Solid" BorderWidth="1px" BackColor="#F7F7DE"
                Font-Size="10pt" Font-Names="Verdana" BorderColor="#CCCC99" HelpPageText="Need help?" HelpPageUrl="recoveryHelp.aspx" onuserlookuperror="PasswordRecovery1_UserLookupError" onload="PasswordRecovery1_Load" >
                <successtemplate>
                    <table border="0" style="font-size:10pt;">
                        <tr>
                            <td>Your password has been sent to you.</td>
                        </tr>
                    </table>
                </successtemplate>
                <titletextstyle font-bold="True" forecolor="White" backcolor="#6B696B">
                </titletextstyle>
            </asp:PasswordRecovery>

        </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">
    
    ' Set the field label background color if the user name is not found.
    Sub PasswordRecovery1_UserLookupError(ByVal sender As Object, ByVal e As System.EventArgs)
        PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Red
    End Sub
    
    ' Reset the field label background color.
    Sub PasswordRecovery1_Load(ByVal sender As Object, ByVal e As System.EventArgs)
        PasswordRecovery1.LabelStyle.ForeColor = System.Drawing.Color.Black
    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:PasswordRecovery id="PasswordRecovery1" runat="server" BorderStyle="Solid" BorderWidth="1px" BackColor="#F7F7DE"
                Font-Size="10pt" Font-Names="Verdana" BorderColor="#CCCC99" HelpPageText="Need help?" HelpPageUrl="recoveryHelp.aspx" onuserlookuperror="PasswordRecovery1_UserLookupError" onload="PasswordRecovery1_Load" >
                <successtemplate>
                    <table border="0" style="font-size:10pt;">
                        <tr>
                            <td>Your password has been sent to you.</td>
                        </tr>
                    </table>
                </successtemplate>
                <titletextstyle font-bold="True" forecolor="White" backcolor="#6B696B">
                </titletextstyle>
            </asp:PasswordRecovery>

        </form>
    </body>
</html>

備註

本主題內容:

簡介

控件 PasswordRecovery 可協助忘記密碼的使用者。 它可讓使用者要求包含新密碼的電子郵件訊息,或已經與其使用者名稱相關聯的密碼。

注意

PasswordRecovery Web 控制項會使用因特網電子郵件服務,將已復原或新的密碼傳送給使用者。 在電子郵件中傳送密碼有固有的安全性風險。 您應該判斷月臺是否可接受這些安全性風險。

注意

如果您不熟悉 ASP.NET 中可用的登入控件集,請先 參閱 ASP.NET 登入控件概觀 ,再繼續進行。 如需與登入控件和成員資格相關的其他主題清單,請參閱 使用成員資格管理使用者

只有在 屬性中 MembershipProvider 定義的成員資格提供者支援純文本或加密密碼時,使用者才能復原密碼。 因為無法復原哈希密碼,所以使用哈希密碼的網站使用者只能重設其密碼。

重要

接受使用者輸入是潛在的安全性威脅。 惡意使用者可以傳送要公開弱點的數據,或執行嘗試產生密碼的程式。 若要改善使用使用者輸入時的安全性,您應該使用控件的驗證功能,並保護針對控件設定的任何數據提供者。 如需詳細資訊,請參閱 保護登入控件Web 應用程式的基本安全性作法,以及 保護成員資格

注意

PasswordRecovery當成員資格使用者尚未核准 (設定false為) MembershipUser.IsApproved 時,可以使用控件,但是當成員資格使用者被鎖定 (MembershipUser.IsLockedOut 設定true為) 時,就無法使用它。

電子郵件訊息會使用 MailDefinition 類別傳送。 若要能夠傳送電子郵件給使用者,您必須在應用程式的 Web.config 檔案中設定郵件伺服器。 您可以藉由在 屬性中 MailDefinition 設定自訂訊息,來變更傳送給使用者的電子郵件內容。

注意

無法保證使用者會收到或檢視電子郵件訊息。 若要確認使用者已透過電子郵件收到通知,請考慮在訊息中提供確認連結,讓使用者確認已收到通知。

檢視

控制項 PasswordRecovery 有三種狀態或檢視:

  • UserName 檢視 -- 詢問使用者其已註冊的用戶名稱。

  • 問題檢視 -- 要求使用者提供儲存問題的解答以重設密碼。

  • 成功檢視 -- 告知使用者密碼復原或重設是否成功。

只有在 屬性中MembershipProvider定義的成員資格提供者支援密碼問題和答案時,控件PasswordRecovery才會顯示 [問題] 檢視。

下表列出控件的每個樣式屬性 PasswordRecovery ,並指出其影響哪些檢視。

屬性 UserName 檢視 問題檢視 成功檢視
SubmitButtonStyle Yes Yes
FailureTextStyle Yes No
HyperLinkStyle Yes No
InstructionTextStyle Yes No
LabelStyle Yes No
SuccessTextStyle No No Yes
TextBoxStyle Yes No
TitleTextStyle Yes Yes

樣式和範本

您可以使用一組廣泛的樣式屬性來自定義控制元件的外觀 PasswordRecovery 。 或者,如果您需要完全控制控件的外觀,您可以將自定義範本套用至三個檢視。 您可以使用 QuestionTemplateSuccessTemplateUserNameTemplate 屬性來建立這些檢視的範本。 如果您定義檢視的範本,的 PasswordRecovery 樣式屬性就不會有任何作用。

下表列出 PasswordRecovery 控件樣式屬性,並說明每個樣式屬性影響哪些UI元素。 如需每個樣式套用的屬性清單,請參閱個別樣式屬性的檔。

Style 屬性 受影響的UI元素
SubmitButtonStyle 在所有檢視上提交按鈕。
FailureTextStyle 向用戶顯示錯誤文字。
HyperLinkStyle 其他頁面的連結。
InstructionTextStyle 頁面上的指示文字,告知使用者如何使用 控件。
LabelStyle 所有輸入欄位的標籤,例如文字框。
TextBoxStyle 文字輸入欄位。
TitleTextStyle 每個檢視的標題文字。
SuccessTextStyle 密碼復原或重設嘗試成功時,向用戶顯示的文字。

下表列出哪些範本屬性會套用至控件中的每個 PasswordRecovery 檢視。 如需您必須在每個範本中設定的控制項清單,請參閱個別範本屬性的檔。

檢視 Template 屬性
UserName UserNameTemplate
問題 QuestionTemplate
Success SuccessTemplate

PasswordRecovery當控件未使用範本自定義時,AccessKey控件的 PasswordRecovery 屬性會套用至控件中的第一個文本框,以及TabIndex套用至控件的所有文本框的屬性。 PasswordRecovery如果控件是使用範本自定義的,則會AccessKey忽略 屬性和 TabIndex 屬性。 在此情況下,請直接設定 AccessKey 每個範本子控件的屬性和 TabIndex 屬性。

PasswordRecovery 文字框所代表的控件屬性,例如 AnswerQuestion,可在頁面生命週期的所有階段中存取。 控件會透過 TextChanged 文本框所觸發的事件,挑選使用者所做的任何變更。

驗證群組

控件 PasswordRecovery 會為控件中的所有必要字段驗證程式建立驗證群組,讓頁面上的其他輸入控件不會受到驗證 PasswordRecovery 控件的影響。 根據預設, ID 控件的 PasswordRecovery 屬性會當做驗證群組的名稱使用。 例如, PasswordRecovery 標識符為 「PasswordRecovery1」 的控件會使用 「PasswordRecovery1」 的驗證組名。 如果您想要 PasswordRecovery 讓控件參與另一個驗證群組,您必須範本控制項。

套用 CSS 樣式

控制項 PasswordRecovery 可讓您在標記中指定 CSS 樣式規則。 如果您使用範本來自定義控制元件的外觀 PasswordRecovery ,您可以在樣本中的標記中指定 CSS 樣式。 在此情況下,不需要額外的外部數據表。 您可以將 屬性設定 RenderOuterTablefalse,以防止數據表轉譯。

Accessibility

如需如何設定此控件以產生符合輔助功能標準的標記的相關信息,請參閱 Visual Studio 中的輔助功能,以及 ASP.NETASP.NET 控件和輔助功能

宣告式語法

<asp:PasswordRecovery
    AccessKey="string"
    AnswerLabelText="string"
    AnswerRequiredErrorMessage="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderPadding="integer"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    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"
    GeneralFailureText="string"
    Height="size"
    HelpPageIconUrl="uri"
    HelpPageText="string"
    HelpPageUrl="uri"
    ID="string"
    MailDefinition-BodyFileName="uri"
    MailDefinition-CC="string"
    MailDefinition-From="string"
    MailDefinition-IsBodyHtml="True|False"
    MailDefinition-Priority="Normal|Low|High"
    MailDefinition-Subject="string"
    MembershipProvider="string"
    OnAnswerLookupError="AnswerLookupError event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSendingMail="SendingMail event handler"
    OnSendMailError="SendMailError event handler"
    OnUnload="Unload event handler"
    OnUserLookupError="UserLookupError event handler"
    OnVerifyingAnswer="VerifyingAnswer event handler"
    OnVerifyingUser="VerifyingUser event handler"
    QuestionFailureText="string"
    QuestionInstructionText="string"
    QuestionLabelText="string"
    QuestionTitleText="string"
    runat="server"
    SkinID="string"
    Style="string"
    SubmitButtonImageUrl="uri"
    SubmitButtonText="string"
    SubmitButtonType="Button|Image|Link"
    SuccessPageUrl="uri"
    SuccessText="string"
    TabIndex="integer"
    TextLayout="TextOnLeft|TextOnTop"
    ToolTip="string"
    UserName="string"
    UserNameFailureText="string"
    UserNameInstructionText="string"
    UserNameLabelText="string"
    UserNameRequiredErrorMessage="string"
    UserNameTitleText="string"
    Visible="True|False"
    Width="size"
>
        <FailureTextStyle />
        <HyperLinkStyle />
        <InstructionTextStyle />
        <LabelStyle />
        <MailDefinition
            BodyFileName="uri"
            CC="string"
            From="string"
            IsBodyHtml="True|False"
            Priority="Normal|Low|High"
            Subject="string"
>
                <EmbeddedObjects>
                        <asp:EmbeddedMailObject
                            Name="string"
                            Path="uri"
                        />
                </EmbeddedObjects>
        </MailDefinition>
        <QuestionTemplate>
            <!-- child controls -->
        </QuestionTemplate>
        <SubmitButtonStyle />
        <SuccessTemplate>
            <!-- child controls -->
        </SuccessTemplate>
        <SuccessTextStyle />
        <TextBoxStyle />
        <TitleTextStyle />
        <UserNameTemplate>
            <!-- child controls -->
        </UserNameTemplate>
        <ValidatorTextStyle />
</asp:PasswordRecovery>

建構函式

PasswordRecovery()

初始化 PasswordRecovery 類別的新執行個體。

欄位

SubmitButtonCommandName

表示按一下 [送出] 按鈕後要執行的命令。

屬性

AccessKey

取得或設定便捷鍵 (Access Key),可讓您快速巡覽至 Web 伺服器控制項。

(繼承來源 WebControl)
Adapter

針對控制項取得瀏覽器的特定配置器。

(繼承來源 Control)
Answer

取得使用者輸入之密碼復原確認問題的解答。

AnswerLabelText

取得或設定密碼確認解答文字方塊的標籤文字。

AnswerRequiredErrorMessage

取得或設定要在解答文字方塊為空白時顯示給使用者的錯誤訊息。

AppRelativeTemplateSourceDirectory

取得或設定包含了此控制項之 PageUserControl 物件的相對應用程式虛擬目錄。

(繼承來源 Control)
Attributes

取得任意屬性 (Attribute) 的集合 (只供呈現),不與控制項上的屬性 (Property) 對應。

(繼承來源 WebControl)
BackColor

取得或設定 Web 伺服器控制項的背景色彩。

(繼承來源 WebControl)
BindingContainer

取得包含了此控制項之資料繫結的控制項。

(繼承來源 Control)
BorderColor

取得或設定 Web 控制項的框線色彩。

(繼承來源 WebControl)
BorderPadding

取得或設定 PasswordRecovery 控制項之框線內部的填補量。

BorderStyle

取得或設定 Web 伺服器控制項的框線樣式。

(繼承來源 WebControl)
BorderWidth

取得或設定 Web 伺服器控制項的框線寬度。

(繼承來源 WebControl)
ChildControlsCreated

取得值,指出是否已經建立伺服器控制項的子控制項。

(繼承來源 Control)
ClientID

取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。

(繼承來源 Control)
ClientIDMode

取得或設定用來產生 ClientID 屬性值的演算法。

(繼承來源 Control)
ClientIDSeparator

取得字元值,表示在 ClientID 屬性中所使用的分隔字元。

(繼承來源 Control)
Context

取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。

(繼承來源 Control)
Controls

取得表示 ControlCollection 中之子控制項的 CompositeControl 物件。

(繼承來源 CompositeControl)
ControlStyle

取得 Web 伺服器控制項的樣式。 這個屬性主要由控制項開發人員使用。

(繼承來源 WebControl)
ControlStyleCreated

取得值,指出 Style 物件是否已經為 ControlStyle 屬性建立。 這個屬性主要由控制項開發人員使用。

(繼承來源 WebControl)
CssClass

取得或設定用戶端上 Web 伺服器控制項所呈現的階層式樣式表 (CSS)。

(繼承來源 WebControl)
DataItemContainer

如果命名容器實作 IDataItemContainer,則取得命名容器的參考。

(繼承來源 Control)
DataKeysContainer

如果命名容器實作 IDataKeysControl,則取得命名容器的參考。

(繼承來源 Control)
DesignMode

取得值,指出控制項是否正用於設計介面上。

(繼承來源 Control)
Enabled

取得或設定值,指出 Web 伺服器控制項是否啟用。

(繼承來源 WebControl)
EnableTheming

取得或設定值,指出佈景主題是否套用至此控制項。

(繼承來源 WebControl)
EnableViewState

取得或設定值,該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態,以及它包含的任何子控制項狀態。

(繼承來源 Control)
Events

取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。

(繼承來源 Control)
FailureTextStyle

取得定義 PasswordRecovery 控制項中錯誤文字外觀之屬性集合的參考。

Font

取得與 Web 伺服器控制項關聯的字型屬性。

(繼承來源 WebControl)
ForeColor

取得或設定 Web 伺服器控制項的前景色彩 (通常是文字的色彩)。

(繼承來源 WebControl)
GeneralFailureText

取得或設定要在 PasswordRecovery 控制項的成員資格提供者發生問題時顯示的錯誤訊息。

HasAttributes

取得值,指出控制項是否已經設定屬性。

(繼承來源 WebControl)
HasChildViewState

取得值,指出目前伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。

(繼承來源 Control)
Height

取得或設定 Web 伺服器控制項的高度。

(繼承來源 WebControl)
HelpPageIconUrl

取得或設定要在 [說明] 頁面的連結旁邊顯示之影像的 URL。

HelpPageText

取得或設定至密碼復原 [說明] 頁面之連結的文字。

HelpPageUrl

取得或設定密碼復原 [說明] 頁面的 URL。

HyperLinkStyle

取得定義 PasswordRecovery 控制項上超連結 (Hyperlink) 外觀之屬性集合的參考。

ID

取得或設定指派給伺服器控制項的程式設計識別項。

(繼承來源 Control)
IdSeparator

取得用來分隔控制項識別項的字元。

(繼承來源 Control)
InstructionTextStyle

取得定義 PasswordRecovery 控制項中闡明文字外觀之樣式屬性集合的參考。

IsChildControlStateCleared

取得值,指出這個控制項中所包含的控制項是否有控制項狀態。

(繼承來源 Control)
IsEnabled

取得值,指出是否啟用控制項。

(繼承來源 WebControl)
IsTrackingViewState

取得值,指出伺服器控制項是否正在儲存檢視狀態的變更。

(繼承來源 Control)
IsViewStateEnabled

取得值,指出這個控制項是否已啟用檢視狀態。

(繼承來源 Control)
LabelStyle

取得定義 PasswordRecovery 控制項中文字方塊標籤外觀之樣式屬性集合的參考。

LoadViewStateByID

取得值,指出控制項是否依 ID (而不是索引) 參與載入其檢視狀態。

(繼承來源 Control)
MailDefinition

取得定義用於將新的或復原的密碼傳送給使用者之電子郵件訊息特性的屬性集合參考。

MembershipProvider

取得或設定用於尋找使用者資訊的成員資格提供者。

NamingContainer

取得伺服器控制項命名容器的參考,其建立唯一命名空間,在具有相同 ID 屬性值的伺服器控制項之間作區別。

(繼承來源 Control)
Page

取得含有伺服器控制項的 Page 執行個體的參考。

(繼承來源 Control)
Parent

在網頁控制階層架構中取得伺服器控制項之父控制項的參考。

(繼承來源 Control)
Question

取得使用者在網站上建立的密碼復原確認問題。

QuestionFailureText

取得或設定要在使用者對密碼復原確認問題的解答與網站資料存放區中儲存的解答不相符時顯示的文字。

QuestionInstructionText

取得或設定要在 [問題] 檢視中顯示的文字,指示使用者回應密碼復原確認問題。

QuestionLabelText

取得或設定 Question 文字方塊的標籤文字。

QuestionTemplate

取得或設定用於顯示 PasswordRecovery 控制項之 [問題] 檢視的樣板。

QuestionTemplateContainer

取得 PasswordRecovery 控制項用來建立 QuestionTemplate 樣板執行個體的容器。 這個屬性提供以程式設計方式存取子控制項。

QuestionTitleText

取得或設定 PasswordRecovery 控制項之 [問題] 檢視的標題。

RenderingCompatibility

取得值,這個值會指定將與呈現 HTML 相容的 ASP.NET 版本。

(繼承來源 Control)
RenderOuterTable

取得或設定值,這個值指出控制項是否會將轉譯的 HTML 放置在 table 項目內,以便套用內嵌樣式。

Site

當呈現在設計介面上時,取得裝載目前控制項之容器的資訊。

(繼承來源 Control)
SkinID

取得或設定要套用至控制項的面板。

(繼承來源 WebControl)
Style

取得文字屬性的集合,將呈現為 Web 伺服器控制項的外部標記上的樣式屬性。

(繼承來源 WebControl)
SubmitButtonImageUrl

取得或設定要用做 [送出] 按鈕之影像的 URL。

SubmitButtonStyle

取得定義 PasswordRecovery 控制項中 [送出] 按鈕外觀之屬性集合的參考。

SubmitButtonText

取得或設定送出表單之按鈕的文字。

SubmitButtonType

取得或設定當呈現 PasswordRecovery 控制項時要使用的 [送出] 按鈕類型。

SuccessPageUrl

取得或設定成功傳送密碼之後要顯示之頁面的 URL。

SuccessTemplate

取得或設定用於顯示 PasswordRecovery 控制項之 [成功] 檢視的樣板。

SuccessTemplateContainer

取得 PasswordRecovery 控制項用來建立 SuccessTemplate 樣板執行個體的容器。 這個屬性提供以程式設計方式存取子控制項。

SuccessText

取得或設定成功傳送密碼之後要顯示的文字。

SuccessTextStyle

取得樣式屬性集合的參考,這些樣式屬性定義 PasswordRecovery 控制項之 [成功] 檢視中顯示的文字外觀。

SupportsDisabledAttribute

取得值,這個值表示當控制項的 disabled 屬性為 IsEnabled 時,控制項是否應該將呈現之 HTML 項目的 false 屬性設為 "disabled"。

(繼承來源 CompositeControl)
TabIndex

取得或設定 Web 伺服器控制項的定位索引。

(繼承來源 WebControl)
TagKey

取得對應於 HtmlTextWriterTag 控制項的 PasswordRecovery 值。

TagName

取得控制項標記的名稱。 這個屬性主要由控制項開發人員使用。

(繼承來源 WebControl)
TemplateControl

取得或設定包含了此控制項之樣板的參考。

(繼承來源 Control)
TemplateSourceDirectory

取得包含目前伺服器控制項的 PageUserControl 的虛擬目錄。

(繼承來源 Control)
TextBoxStyle

取得定義 PasswordRecovery 控制項中文字方塊外觀之樣式屬性集合的參考。

TextLayout

取得或設定值,其指定以水平配置還是垂直配置顯示 PasswordRecovery 控制項。

TitleTextStyle

取得定義 PasswordRecovery 控制項中出現的標題文字外觀之樣式屬性集合的參考。

ToolTip

取得或設定當滑鼠指標停留在 Web 伺服器控制項時顯示的文字。

(繼承來源 WebControl)
UniqueID

取得伺服器控制項唯一的、符合階層架構的識別項。

(繼承來源 Control)
UserName

取得或設定 [使用者名稱] 文字方塊中出現的文字。

UserNameFailureText

取得或設定要在使用者輸入的使用者名稱不是網站的有效使用者名稱時顯示的文字。

UserNameInstructionText

取得或設定要在 PasswordRecovery 控制項的 [使用者名稱] 檢視中顯示的文字,指示使用者輸入使用者名稱。

UserNameLabelText

取得或設定 [使用者名稱] 文字方塊標籤的文字。

UserNameRequiredErrorMessage

取得或設定要在使用者將 [使用者名稱] 文字方塊留為空白時顯示的錯誤訊息。

UserNameTemplate

取得或設定用於顯示 PasswordRecovery 控制項之 [使用者名稱] 檢視的樣板。

UserNameTemplateContainer

取得 PasswordRecovery 控制項用來建立 UserNameTemplate 樣板執行個體的容器。 這個屬性提供以程式設計方式存取子控制項。

UserNameTitleText

取得或設定 PasswordRecovery 控制項之 [使用者名稱] 檢視的標題。

ValidateRequestMode

取得或設定值,指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。

(繼承來源 Control)
ValidatorTextStyle

取得定義錯誤訊息外觀的 Style 屬性集合參考,該錯誤訊息與 PasswordRecovery 控制項使用的任何輸入驗證相關聯。

ViewState

取得狀態資訊的字典,允許您在相同網頁的多個要求之間,儲存和還原伺服器控制項的檢視狀態。

(繼承來源 Control)
ViewStateIgnoresCase

取得值,指出 StateBag 物件是否不區分大小寫。

(繼承來源 Control)
ViewStateMode

取得或設定這個控制項的檢視狀態模式。

(繼承來源 Control)
Visible

取得或設定值,指出伺服器控制項是否會轉譯為頁面上的 UI。

(繼承來源 Control)
Width

取得或設定 Web 伺服器控制項的寬度。

(繼承來源 WebControl)

方法

AddAttributesToRender(HtmlTextWriter)

將需要呈現的 HTML 屬性和樣式加入至指定的 HtmlTextWriterTag 中。 這個方法主要由控制項開發人員使用。

(繼承來源 WebControl)
AddedControl(Control, Int32)

在子控制項加入 Control 物件的 Controls 集合後呼叫。

(繼承來源 Control)
AddParsedSubObject(Object)

通知伺服器控制項,XML 或 HTML 項目已剖析,並將項目加入伺服器控制項的 ControlCollection 物件中。

(繼承來源 Control)
ApplyStyle(Style)

將指定樣式的任何非空白項目加入到 Web 控制項中,覆寫控制項的任何現有的樣式項目。 這個方法主要由控制項開發人員使用。

(繼承來源 WebControl)
ApplyStyleSheetSkin(Page)

將頁面樣式表中所定義的樣式屬性套用至控制項。

(繼承來源 Control)
BeginRenderTracing(TextWriter, Object)

開始進行轉譯資料的設計階段追蹤。

(繼承來源 Control)
BuildProfileTree(String, Boolean)

收集伺服器控制項的相關資訊,並在頁面啟用追蹤時將此資訊傳遞至 Trace 屬性以顯示之。

(繼承來源 Control)
ClearCachedClientID()

將快取的 ClientID 值設定為 null

(繼承來源 Control)
ClearChildControlState()

刪除伺服器控制項之子控制項的控制項狀態資訊。

(繼承來源 Control)
ClearChildState()

刪除所有伺服器控制項之子控制項的檢視狀態和控制項狀態資訊。

(繼承來源 Control)
ClearChildViewState()

刪除所有伺服器控制項之子控制項的檢視狀態資訊。

(繼承來源 Control)
ClearEffectiveClientIDMode()

將目前的控制項執行個體和任何子控制項的 ClientIDMode 屬性設定為 Inherit

(繼承來源 Control)
CopyBaseAttributes(WebControl)

將不被 Style 物件封裝的屬性從指定的 Web 伺服器控制項複製到呼叫這個方法的 Web 伺服器控制項上。 這個方法主要由控制項開發人員使用。

(繼承來源 WebControl)
CreateChildControls()

建立組成 PasswordRecovery 控制項的個別控制項。

CreateControlCollection()

建立新的 ControlCollection 物件來保存伺服器控制項的子控制項 (常值和伺服器)。

(繼承來源 Control)
CreateControlStyle()

建立樣式物件,這個物件被 WebControl 類別內部使用,以實作所有的樣式相關屬性。 這個方法主要由控制項開發人員使用。

(繼承來源 WebControl)
DataBind()

繫結資料來源至 CompositeControl 以及其所有子控制項。

(繼承來源 CompositeControl)
DataBind(Boolean)

使用會引發 DataBinding 事件的選項,繫結資料來源至叫用的伺服器控制項及其所有子控制項。

(繼承來源 Control)
DataBindChildren()

繫結資料來源至伺服器控制項的子控制項。

(繼承來源 Control)
Dispose()

啟用伺服器控制項,在它從記憶體釋放之前執行最後清除。

(繼承來源 Control)
EndRenderTracing(TextWriter, Object)

結束轉譯資料的設計階段追蹤。

(繼承來源 Control)
EnsureChildControls()

判斷伺服器控制項是否包含子控制項。 如果不包含,則建立子控制項。

(繼承來源 Control)
EnsureID()

為尚未指定識別項的控制項,建立識別項。

(繼承來源 Control)
Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
FindControl(String)

在目前命名容器搜尋具有指定 id 參數的伺服器控制項。

(繼承來源 Control)
FindControl(String, Int32)

使用指定的 id 和有助於搜尋之 pathOffset 參數中所指定的整數,在目前的命名容器中搜尋伺服器控制項。 您不應該覆寫這個版本的 FindControl 方法。

(繼承來源 Control)
Focus()

設定控制項的輸入焦點。

(繼承來源 Control)
GetDesignModeState()

取得控制項的設計階段資料。

(繼承來源 Control)
GetHashCode()

做為預設雜湊函式。

(繼承來源 Object)
GetRouteUrl(Object)

取得會對應於一組路由參數的 URL。

(繼承來源 Control)
GetRouteUrl(RouteValueDictionary)

取得會對應於一組路由參數的 URL。

(繼承來源 Control)
GetRouteUrl(String, Object)

取得 URL,此 URL 對應於一組路由參數及一個路由名稱。

(繼承來源 Control)
GetRouteUrl(String, RouteValueDictionary)

取得 URL,此 URL 對應於一組路由參數及一個路由名稱。

(繼承來源 Control)
GetType()

取得目前執行個體的 Type

(繼承來源 Object)
GetUniqueIDRelativeTo(Control)

傳回指定之控制項 UniqueID 屬性的前置部分。

(繼承來源 Control)
HasControls()

判斷伺服器控制項是否包含任何子控制項。

(繼承來源 Control)
HasEvents()

傳回值,指出控制項或任何子控制項的事件是否已註冊。

(繼承來源 Control)
IsLiteralContent()

判斷伺服器控制項是否只儲存常值內容。

(繼承來源 Control)
LoadControlState(Object)

實作基底 LoadControlState(Object) 方法。

LoadViewState(Object)

實作基底 LoadViewState(Object) 方法。

MapPathSecure(String)

擷取虛擬絕對路徑或相對路徑所對應至的實體路徑。

(繼承來源 Control)
MemberwiseClone()

建立目前 Object 的淺層複製。

(繼承來源 Object)
MergeStyle(Style)

將指定樣式的任何非空白項目複製到 Web 控制項,但不覆寫控制項的任何現有樣式項目。 這個方法主要由控制項開發人員使用。

(繼承來源 WebControl)
OnAnswerLookupError(EventArgs)

引發 AnswerLookupError 事件。

OnBubbleEvent(Object, EventArgs)

決定伺服器控制項的事件是否要在頁面的 UI 伺服器控制項階層架構中向上傳遞。

OnDataBinding(EventArgs)

引發 DataBinding 事件。

(繼承來源 Control)
OnInit(EventArgs)

實作基底 OnInit(EventArgs) 方法。

OnLoad(EventArgs)

引發 Load 事件。

(繼承來源 Control)
OnPreRender(EventArgs)

實作基底 OnPreRender(EventArgs) 方法。

OnSendingMail(MailMessageEventArgs)

引發 SendingMail 事件。

OnSendMailError(SendMailErrorEventArgs)

當電子郵件訊息無法傳送給使用者時,引發 SendMailError 事件。

OnUnload(EventArgs)

引發 Unload 事件。

(繼承來源 Control)
OnUserLookupError(EventArgs)

引發 UserLookupError 事件。

OnVerifyingAnswer(LoginCancelEventArgs)

引發 VerifyingAnswer 事件。

OnVerifyingUser(LoginCancelEventArgs)

引發 VerifyingUser 事件。

OpenFile(String)

取得用來讀取檔案的 Stream

(繼承來源 Control)
RaiseBubbleEvent(Object, EventArgs)

指派事件的任何來源和它的資訊至控制項的父控制項。

(繼承來源 Control)
RecreateChildControls()

重新建立衍生自 CompositeControl 之控制項的子控制項。

(繼承來源 CompositeControl)
RemovedControl(Control)

Control 物件的 Controls 集合中移除子控制項之後呼叫。

(繼承來源 Control)
Render(HtmlTextWriter)

CompositeControl 內容寫入指定的 HtmlTextWriter 物件,以顯示於用戶端。

RenderBeginTag(HtmlTextWriter)

將控制項的 HTML 開頭標記呈現在指定的寫入器中。 這個方法主要由控制項開發人員使用。

(繼承來源 WebControl)
RenderChildren(HtmlTextWriter)

將伺服器控制項子系的內容輸出至提供的 HtmlTextWriter 物件,再由這個物件在用戶端上寫入要轉譯的內容。

(繼承來源 Control)
RenderContents(HtmlTextWriter)

將控制項的內容呈現在指定的寫入器。 這個方法主要由控制項開發人員使用。

(繼承來源 WebControl)
RenderControl(HtmlTextWriter)

將伺服器控制項內容輸出至提供的 HtmlTextWriter 物件,並在啟用追蹤時儲存控制項的追蹤資訊。

(繼承來源 Control)
RenderControl(HtmlTextWriter, ControlAdapter)

使用提供的 HtmlTextWriter 物件,輸出伺服器控制項內容至提供的 ControlAdapter 物件。

(繼承來源 Control)
RenderEndTag(HtmlTextWriter)

將控制項的 HTML 結尾標記呈現至指定的寫入器。 這個方法主要由控制項開發人員使用。

(繼承來源 WebControl)
ResolveAdapter()

取得負責呈現指定之控制項的控制項配置器。

(繼承來源 Control)
ResolveClientUrl(String)

取得瀏覽器可使用的 URL。

(繼承來源 Control)
ResolveUrl(String)

將 URL 轉換為要求用戶端可使用的 URL。

(繼承來源 Control)
SaveControlState()

儲存頁面回傳至伺服器以來,所發生的任何伺服器控制項狀態變更。

SaveViewState()

儲存叫用 TrackViewState() 方法後已修改的任何狀態。

SetDesignModeState(IDictionary)

實作基底 IControlDesignerAccessor.SetDesignModeState(IDictionary) 方法。

SetRenderMethodDelegate(RenderMethod)

指定事件處理常式委派,以呈現伺服器控制項及其內容至其父控制項。

(繼承來源 Control)
SetTraceData(Object, Object)

使用追蹤資料機碼和追蹤資料值,設定設計階段期間追蹤呈現資料的追蹤資料。

(繼承來源 Control)
SetTraceData(Object, Object, Object)

使用追蹤的物體、追蹤資料機碼和追蹤資料值,設定設計階段期間追蹤呈現資料的追蹤資料。

(繼承來源 Control)
ToString()

傳回代表目前物件的字串。

(繼承來源 Object)
TrackViewState()

實作基底 TrackViewState() 方法。

事件

AnswerLookupError

使用者沒有輸入密碼復原確認問題的正確解答時發生。

DataBinding

發生於伺服器控制項繫結至資料來源時。

(繼承來源 Control)
Disposed

發生於伺服器控制項從記憶體釋放時,這是在要求 ASP.NET 網頁時,伺服器控制項生命週期的最後階段。

(繼承來源 Control)
Init

發生於初始化伺服器控制項時,是其生命週期中的第一個步驟。

(繼承來源 Control)
Load

發生於載入伺服器控制項至 Page 物件時。

(繼承來源 Control)
PreRender

Control 物件載入之後但在呈現之前發生。

(繼承來源 Control)
SendingMail

在藉由電子郵件將密碼傳送至使用者之前發生。

SendMailError

當 SMTP 郵件系統在嘗試傳送電子郵件訊息時擲回錯誤,則會發生。

Unload

發生於伺服器控制項從記憶體卸載時。

(繼承來源 Control)
UserLookupError

當成員資格提供者找不到使用者輸入的使用者名稱時發生。

VerifyingAnswer

使用者送出密碼復原確認問題的解答時發生。

VerifyingUser

在成員資格提供者驗證使用者名稱之前發生。

明確介面實作

IAttributeAccessor.GetAttribute(String)

使用指定的名稱,取得 Web 控制項的屬性。

(繼承來源 WebControl)
IAttributeAccessor.SetAttribute(String, String)

將 Web 控制項的屬性設定為指定的名稱和值。

(繼承來源 WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

讓設計工具能在設計階段環境中重新建立複合控制項的子控制項集合。

(繼承來源 CompositeControl)
IControlBuilderAccessor.ControlBuilder

如需這個成員的說明,請參閱 ControlBuilder

(繼承來源 Control)
IControlDesignerAccessor.GetDesignModeState()

如需這個成員的說明,請參閱 GetDesignModeState()

(繼承來源 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

如需這個成員的說明,請參閱 SetDesignModeState(IDictionary)

(繼承來源 Control)
IControlDesignerAccessor.SetOwnerControl(Control)

如需這個成員的說明,請參閱 SetOwnerControl(Control)

(繼承來源 Control)
IControlDesignerAccessor.UserData

如需這個成員的說明,請參閱 UserData

(繼承來源 Control)
IDataBindingsAccessor.DataBindings

如需這個成員的說明,請參閱 DataBindings

(繼承來源 Control)
IDataBindingsAccessor.HasDataBindings

如需這個成員的說明,請參閱 HasDataBindings

(繼承來源 Control)
IExpressionsAccessor.Expressions

如需這個成員的說明,請參閱 Expressions

(繼承來源 Control)
IExpressionsAccessor.HasExpressions

如需這個成員的說明,請參閱 HasExpressions

(繼承來源 Control)
IParserAccessor.AddParsedSubObject(Object)

如需這個成員的說明,請參閱 AddParsedSubObject(Object)

(繼承來源 Control)

擴充方法

FindDataSourceControl(Control)

傳回與指定之控制項的資料控制項相關聯的資料來源。

FindFieldTemplate(Control, String)

傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。

FindMetaTable(Control)

傳回包含資料控制項的中繼資料表物件。

GetDefaultValues(INamingContainer)

取得所指定資料控制項的預設值集合。

GetMetaTable(INamingContainer)

取得所指定資料控制項中的資料表中繼資料。

SetMetaTable(INamingContainer, MetaTable)

設定所指定資料控制項中的資料表中繼資料。

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

設定所指定資料控制項的資料表中繼資料及預設值對應。

SetMetaTable(INamingContainer, MetaTable, Object)

設定所指定資料控制項的資料表中繼資料及預設值對應。

TryGetMetaTable(INamingContainer, MetaTable)

判斷資料表中繼資料是否可供使用。

EnableDynamicData(INamingContainer, Type)

針對指定的資料控制項啟用動態資料行為。

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

針對指定的資料控制項啟用動態資料行為。

EnableDynamicData(INamingContainer, Type, Object)

針對指定的資料控制項啟用動態資料行為。

適用於

另請參閱