PasswordRecovery Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Fornece elementos de interface de utilizador (UI) que permitem ao utilizador recuperar ou redefinir uma palavra-passe perdida e recebê-la por email.

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

Herança: Object

Control

WebControl

CompositeControl
PasswordRecovery

Atributos: BindableAttribute

Exemplos

O exemplo de código seguinte demonstra a utilização do PasswordRecovery controlo.

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

Observações

Neste tópico:

Introdução
Views
Estilos e Modelos
Agrupamentos de validação
Aplicação de Estilos CSS
Acessibilidade
Sintaxe declarativa

Introdução

O PasswordRecovery controlo ajuda utilizadores que se esqueceram das suas palavras-passe. Permite ao utilizador solicitar uma mensagem de email contendo uma nova palavra-passe ou a palavra-passe já associada ao seu nome de utilizador.

Note

O controlo PasswordRecovery Web utiliza serviços de email na Internet para enviar palavras-passe recuperadas ou novas aos utilizadores. Existem riscos de segurança inerentes ao enviar palavras-passe por email. Deve determinar se estes riscos de segurança são aceitáveis para o seu site.

Note

Se não estiver familiarizado com o conjunto de controlos de login disponíveis em ASP.NET, consulte ASP.NET Visão Geral dos Controlos de Login antes de continuar. Para uma lista de outros tópicos relacionados com controlos de login e membros, consulte Gerir Utilizadores através do Uso da Adesão.

Os utilizadores só podem recuperar palavras-passe quando o fornecedor de membros definido na MembershipProvider propriedade suporta palavras-passe em texto claro ou encriptadas. Como as palavras-passe hashadas não podem ser recuperadas, os utilizadores em sites que usam palavras-passe hashadas só podem redefinir as suas palavras-passe.

Importante

Aceitar a entrada do utilizador é uma potencial ameaça à segurança. Utilizadores maliciosos podem enviar dados destinados a expor vulnerabilidades ou executar programas que tentem palavras-passe geradas. Para melhorar a segurança ao trabalhar com a entrada do utilizador, deve utilizar as funcionalidades de validação do seu controlo e proteger quaisquer fornecedores de dados configurados para o seu controlo. Para mais informações, consulte Segurança dos Controlos de Login, Práticas Básicas de Segurança para Aplicações Web e Segurança da Adesão.

Note

O PasswordRecovery controlo pode ser usado quando um utilizador de subscrição não foi aprovado (MembershipUser.IsApproved está definido para false), mas não pode ser usado quando um utilizador de subscrição foi bloqueado (MembershipUser.IsLockedOut está definido para true).

A mensagem de email é enviada através da MailDefinition turma. Para poder enviar emails aos utilizadores, deve configurar um servidor de email no ficheiro Web.config da sua aplicação. Pode alterar o conteúdo do email enviado aos utilizadores definindo uma mensagem personalizada na MailDefinition propriedade.

Note

Não é possível garantir que um utilizador receberá ou verá uma mensagem de email. Para verificar se um utilizador recebeu uma notificação por email, considere fornecer um link de confirmação na mensagem, permitindo ao utilizador confirmar que a notificação foi recebida.

Visualizações

O PasswordRecovery controlo tem três estados, ou opiniões:

Visualização de Nome de Utilizador -- Pede ao utilizador o nome de utilizador registado.
Vista de perguntas -- Exige que o utilizador forneça a resposta a uma pergunta armazenada para redefinir a palavra-passe.
Vista de sucesso -- Indica ao utilizador se a recuperação ou redefinição da palavra-passe foi bem-sucedida.

O PasswordRecovery controlo mostra a vista Pergunta apenas quando o fornecedor de membros definido na MembershipProvider propriedade suporta pergunta e resposta por palavra-passe.

A tabela seguinte lista cada propriedade de estilo do PasswordRecovery controlo e indica qual a vista que esta afeta.

Property	Vista de Nome de Utilizador	Vista de perguntas	Visão do sucesso
SubmitButtonStyle	Yes	Yes	Yes
FailureTextStyle	Yes	Yes	No
HyperLinkStyle	Yes	Yes	No
InstructionTextStyle	Yes	Yes	No
LabelStyle	Yes	Yes	No
SuccessTextStyle	No	No	Yes
TextBoxStyle	Yes	Yes	No
TitleTextStyle	Yes	Yes	Yes

Estilos e modelos

Pode usar um conjunto extenso de propriedades de estilo para personalizar a aparência do PasswordRecovery controlo. Alternativamente, pode aplicar modelos personalizados às três vistas se precisar de controlo total sobre a aparência do controlo. Pode usar as QuestionTemplatepropriedades , SuccessTemplate e UserNameTemplate para criar modelos para estas vistas. Se definires um modelo para uma vista, as propriedades de estilo de PasswordRecovery não têm efeito.

A tabela seguinte lista as PasswordRecovery propriedades do estilo de controlo e explica qual o elemento da interface que cada propriedade de estilo afeta. Para uma lista das propriedades a que cada estilo se aplica, consulte a documentação das propriedades individuais do estilo.

Propriedade de estilo	Elemento UI afetado
SubmitButtonStyle	Botões de submissão em todas as visualizações.
FailureTextStyle	Texto de erro apresentado ao utilizador.
HyperLinkStyle	Ligações para outras páginas.
InstructionTextStyle	Texto instrutivo na página que indica aos utilizadores como usar o controlo.
LabelStyle	Etiquetas para todos os campos de entrada, como caixas de texto.
TextBoxStyle	Campos de introdução de texto.
TitleTextStyle	Texto do título para cada vista.
SuccessTextStyle	Texto apresentado ao utilizador quando a tentativa de recuperação ou redefinição da palavra-passe for bem-sucedida.

A tabela seguinte lista quais as propriedades do template que se aplicam a cada vista no PasswordRecovery controlo. Para uma lista dos controlos que deve definir em cada modelo, consulte a documentação das propriedades individuais do modelo.

View	Propriedade do modelo
UserName	UserNameTemplate
Pergunta	QuestionTemplate
Sucesso	SuccessTemplate

Quando o PasswordRecovery controlo não é personalizado com templates, a AccessKey propriedade do PasswordRecovery controlo aplica-se à primeira caixa de texto no controlo e à TabIndex propriedade, que é aplicada a todas as caixas de texto do controlo. Se o controlo PasswordRecovery for personalizado com templates, então a AccessKey propriedade e a TabIndex propriedade são ignoradas. Neste caso, defina diretamente a AccessKey propriedade e a TabIndex propriedade de cada modelo de controlo filho.

PasswordRecovery As propriedades de controlo representadas por caixas de texto, como Answer e Question, são acessíveis durante todas as fases do ciclo de vida da página. O controlo irá detetar quaisquer alterações feitas pelo utilizador final através do TextChanged evento desencadeado pelas caixas de texto.

Agrupamentos de validação

O PasswordRecovery controlo cria um grupo de validação para todos os validadores de campo necessários no controlo, de modo a que outros controlos de entrada na página não sejam afetados pela validação do PasswordRecovery controlo. Por defeito, a ID propriedade do PasswordRecovery controlo é usada como nome do grupo de validação. Por exemplo, um PasswordRecovery controlo com o ID "PasswordRecovery1" usará o nome de grupo de validação "PasswordRecovery1". Se quiser que o PasswordRecovery controlo participe noutro grupo de validação, deve modelar o controlo.

Aplicação de Estilos CSS

O PasswordRecovery controlo permite-te especificar regras de estilo CSS na marcação. Se usares templates para personalizar a aparência do PasswordRecovery controlo, podes especificar estilos CSS na marcação dos templates. Nesse caso, não é necessária uma mesa exterior extra. Pode impedir que a tabela seja renderizada definindo a RenderOuterTable propriedade para false.

Accessibility

Para informações sobre como configurar este controlo de modo a gerar marcação que cumpra os padrões de acessibilidade, consulte Acessibilidade em Visual Studio e ASP.NET e ASP.NET Controlos e Acessibilidade.

Sintaxe declarativa

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

Construtores

Name	Description
PasswordRecovery()	Inicializa uma nova instância da PasswordRecovery classe.

Campos

Name	Description
SubmitButtonCommandName	Representa o comando a executar quando o botão Enviar é clicado.

Propriedades

Name	Description
AccessKey	Obtém ou define a chave de acesso que permite navegar rapidamente até ao controlo do servidor Web. (Herdado de WebControl)
Adapter	Recebe o adaptador específico do navegador para o controlo. (Herdado de Control)
Answer	Obtém a resposta à pergunta de confirmação de recuperação de palavra-passe introduzida pelo utilizador.
AnswerLabelText	Recebe ou define o texto do rótulo para a caixa de texto de resposta de confirmação de palavra-passe.
AnswerRequiredErrorMessage	Recebe ou define a mensagem de erro apresentada ao utilizador quando a caixa de texto Resposta está em branco.
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control)
Attributes	Obtém a coleção de atributos arbitrários (apenas para renderização) que não correspondem a propriedades no controlo. (Herdado de WebControl)
BackColor	Obtém ou define a cor de fundo do controlo do servidor Web. (Herdado de WebControl)
BindingContainer	Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control)
BorderColor	Obtém ou define a cor da borda do controlo Web. (Herdado de WebControl)
BorderPadding	Obtém ou define a quantidade de enchimento dentro das bordas do PasswordRecovery controlo.
BorderStyle	Obtém ou define o estilo de borda do controlo do servidor Web. (Herdado de WebControl)
BorderWidth	Obtém ou define a largura da fronteira do controlo do servidor Web. (Herdado de WebControl)
ChildControlsCreated	Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control)
ClientID	Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade. (Herdado de Control)
ClientIDSeparator	Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control)
Context	Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control)
Controls	Obtém um ControlCollection objeto que representa os controlos filhos num CompositeControl. (Herdado de CompositeControl)
ControlStyle	Recebe o estilo do controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
ControlStyleCreated	Recebe um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
CssClass	Obtém ou define a classe Cascading Style Sheet (CSS) renderizada pelo controlo do servidor Web no cliente. (Herdado de WebControl)
DataItemContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control)
DesignMode	Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control)
Enabled	Recebe ou define um valor que indica se o controlo do servidor Web está ativado. (Herdado de WebControl)
EnableTheming	Recebe ou define um valor que indica se os temas se aplicam a este controlo. (Herdado de WebControl)
EnableViewState	Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control)
FailureTextStyle	Obtém uma referência a uma coleção de propriedades que definem a aparência do texto de erro no PasswordRecovery controlo.
Font	Obtém as propriedades da fonte associadas ao controlo do servidor Web. (Herdado de WebControl)
ForeColor	Obtém ou define a cor do primeiro plano (tipicamente a cor do texto) do controlo do servidor Web. (Herdado de WebControl)
GeneralFailureText	Recebe ou define a mensagem de erro para ser exibida quando há um problema com o fornecedor de subscrição do PasswordRecovery controlo.
HasAttributes	Recebe um valor que indica se o controlo tem atributos definidos. (Herdado de WebControl)
HasChildViewState	Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control)
Height	Obtém ou define a altura do controlo do servidor Web. (Herdado de WebControl)
HelpPageIconUrl	Obtém ou define a URL de uma imagem para ser exibida ao lado do link para a página de Ajuda.
HelpPageText	Obtém ou define o texto do link para a página de Ajuda para recuperação de palavra-passe.
HelpPageUrl	Obtém ou define o URL da página de Ajuda para recuperação de palavra-passe.
HyperLinkStyle	Obtém uma referência a um conjunto de propriedades que definem a aparência de hiperligações no PasswordRecovery controlo.
ID	Obtém ou define o identificador programático atribuído ao controlo do servidor. (Herdado de Control)
IdSeparator	Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control)
InstructionTextStyle	Obtém uma referência a um conjunto de propriedades de estilo que definem a aparência do texto explicativo no PasswordRecovery controlo.
IsChildControlStateCleared	Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control)
IsEnabled	Recebe um valor que indica se o controlo está ativado. (Herdado de WebControl)
IsTrackingViewState	Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control)
IsViewStateEnabled	Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control)
LabelStyle	Obtém uma referência a um conjunto de propriedades de estilo que definem a aparência das etiquetas das caixas de texto no PasswordRecovery controlo.
LoadViewStateByID	Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control)
MailDefinition	Obtém uma referência a um conjunto de propriedades que definem as características das mensagens de email usadas para enviar novas ou recuperadas palavras-passe aos utilizadores.
MembershipProvider	Obtém ou define o fornecedor de membros usado para consultar informações dos utilizadores.
NamingContainer	Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control)
Page	Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control)
Parent	Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control)
Question	Obtém a pergunta de confirmação de recuperação de palavra-passe estabelecida pelo utilizador no site.
QuestionFailureText	Recebe ou define o texto para ser exibido quando a resposta do utilizador à pergunta de confirmação de recuperação de palavra-passe não corresponde à resposta armazenada no armazenamento de dados do site.
QuestionInstructionText	Obtém ou define o texto para ser exibido na vista da Pergunta para instruir o utilizador a responder à pergunta de confirmação de recuperação de palavra-passe.
QuestionLabelText	Obtém ou define o texto do rótulo para a Question caixa de texto.
QuestionTemplate	Obtém ou define o modelo usado para mostrar a vista Pergunta do PasswordRecovery controlo.
QuestionTemplateContainer	Obtém o contentor que um PasswordRecovery controlo usou para criar uma instância do QuestionTemplate template. Esta propriedade fornece acesso programático a controlos filhos.
QuestionTitleText	Recebe ou define o título para a vista Pergunta do PasswordRecovery controlo.
RenderingCompatibility	Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
RenderOuterTable	Recebe ou define um valor que indica se o controlo envolve HTML renderizado num `table` elemento para aplicar estilos inline.
Site	Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control)
SkinID	Obtém ou fixa a pele para aplicar no controlo. (Herdado de WebControl)
Style	Recebe uma coleção de atributos de texto que serão renderizados como um atributo de estilo na etiqueta externa do controlo do servidor Web. (Herdado de WebControl)
SubmitButtonImageUrl	Obtém ou define a URL de uma imagem para usar como o botão Submeter.
SubmitButtonStyle	Obtém uma referência a um conjunto de propriedades que definem a aparência dos botões Submeter no PasswordRecovery controlo.
SubmitButtonText	Obtém ou define o texto do botão que submete o formulário.
SubmitButtonType	Recebe ou define o tipo de botão Submit a usar ao renderizar o PasswordRecovery controlo.
SuccessPageUrl	Obtém ou define o URL da página para mostrar após enviar uma palavra-passe com sucesso.
SuccessTemplate	Obtém ou define o modelo usado para mostrar a vista de Sucesso do PasswordRecovery controlo.
SuccessTemplateContainer	Obtém o contentor que um PasswordRecovery controlo usou para criar uma instância do SuccessTemplate template. Esta propriedade fornece acesso programático a controlos filhos.
SuccessText	Obtém ou define o texto para mostrar depois de enviar uma palavra-passe com sucesso.
SuccessTextStyle	Obtém uma referência a uma coleção de propriedades de estilo que definem a aparência do texto apresentado na vista Sucesso do PasswordRecovery controlo.
SupportsDisabledAttribute	Obtém um valor que indica se o controlo deve definir o `disabled` atributo do elemento HTML renderizado como "desabilitado" quando a propriedade do IsEnabled controlo é `false`. (Herdado de CompositeControl)
TabIndex	Obtém ou define o índice de tabulação do controlo do servidor Web. (Herdado de WebControl)
TagKey	Obtém o HtmlTextWriterTag valor que corresponde a um PasswordRecovery controlo.
TagName	Recebe o nome da etiqueta de controlo. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
TemplateControl	Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control)
TextBoxStyle	Obtém uma referência a um conjunto de propriedades de estilo que definem a aparência das caixas de texto no PasswordRecovery controlo.
TextLayout	Recebe ou define um valor que especifica se deve mostrar o PasswordRecovery controlo numa disposição horizontal ou vertical.
TitleTextStyle	Obtém uma referência a uma coleção de propriedades de estilo que definem a aparência do texto do título que aparece no PasswordRecovery controlo.
ToolTip	Obtém ou define o texto exibido quando o ponteiro do rato paira sobre o controlo do servidor Web. (Herdado de WebControl)
UniqueID	Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control)
UserName	Obtém ou define o texto que aparece na caixa de texto do Nome de Utilizador.
UserNameFailureText	Recebe ou define o texto exibido quando o nome de utilizador introduzido pelo utilizador não é válido para o site.
UserNameInstructionText	Obtém ou define o texto para ser exibido na vista de Nome de Utilizador do PasswordRecovery controlo para instruir o utilizador a inserir um nome de utilizador.
UserNameLabelText	Obtém ou define o texto do rótulo para a caixa de texto do Nome de Utilizador.
UserNameRequiredErrorMessage	Recebe ou define a mensagem de erro exibida quando um utilizador deixa a caixa de texto do Nome de Utilizador vazia.
UserNameTemplate	Obtém ou define o modelo usado para mostrar a vista de Nome de Utilizador do PasswordRecovery controlo.
UserNameTemplateContainer	Obtém o contentor que um PasswordRecovery controlo usou para criar uma instância do UserNameTemplate template. Esta propriedade fornece acesso programático a controlos filhos.
UserNameTitleText	Obtém ou define o título para a vista de Nome de Utilizador do PasswordRecovery controlo.
ValidateRequestMode	Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
ValidatorTextStyle	Obtém uma referência a um conjunto de Style propriedades que definem a aparência de mensagens de erro associadas a qualquer validação de entrada usada pelo PasswordRecovery controlo.
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo view-state deste controlo. (Herdado de Control)
Visible	Recebe ou define um valor que indica se um controlo de servidor é renderizado como UI na página. (Herdado de Control)
Width	Obtém ou define a largura do controlo do servidor Web. (Herdado de WebControl)

Métodos

Name	Description
AddAttributesToRender(HtmlTextWriter)	Adiciona atributos e estilos HTML que precisam de ser renderizados para o especificado HtmlTextWriterTag. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
AddedControl(Control, Int32)	Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor. (Herdado de Control)
ApplyStyle(Style)	Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, sobrescrevendo quaisquer elementos de estilo existentes do controlo. Este método é usado principalmente por desenvolvedores de controlo. (Herdado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor em ClientID cache para `null`. (Herdado de Control)
ClearChildControlState()	Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control)
ClearChildState()	Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control)
ClearChildViewState()	Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control)
CopyBaseAttributes(WebControl)	Copia as propriedades não encapsuladas pelo Style objeto do controlo do servidor Web especificado para o controlo do servidor Web de onde este método é chamado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
CreateChildControls()	Cria os controlos individuais que compõem o PasswordRecovery controlo.
CreateControlCollection()	Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor. (Herdado de Control)
CreateControlStyle()	Cria o objeto de estilo que é usado internamente pela WebControl classe para implementar todas as propriedades relacionadas com o estilo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
DataBind()	Vincula uma fonte de dados ao CompositeControl e a todos os seus controlos filhos. (Herdado de CompositeControl)
DataBind(Boolean)	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control)
DataBindChildren()	Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control)
Dispose()	Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control)
EnsureChildControls()	Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control)
EnsureID()	Cria um identificador para controlos que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindControl(String, Int32)	Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado `id` e um inteiro, especificados no `pathOffset` parâmetro, o que auxilia na pesquisa. Não deve sobrepor-se a esta versão do FindControl método. (Herdado de Control)
FindControl(String)	Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado `id` . (Herdado de Control)
Focus()	Define o foco de entrada num controlo. (Herdado de Control)
GetDesignModeState()	Obtém dados de tempo de projeto para um controlo. (Herdado de Control)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetRouteUrl(Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(String, Object)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control)
HasControls()	Determina se o controlo do servidor contém algum controlo filho. (Herdado de Control)
HasEvents()	Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control)
IsLiteralContent()	Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Implementa o método base LoadControlState(Object) .
LoadViewState(Object)	Implementa o método base LoadViewState(Object) .
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
MergeStyle(Style)	Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, mas não sobrescreve quaisquer elementos de estilo existentes do controlo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
OnAnswerLookupError(EventArgs)	Eleva o AnswerLookupError evento.
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controlo do servidor é passado para a hierarquia de controlo do servidor UI da página.
OnDataBinding(EventArgs)	Eleva o DataBinding evento. (Herdado de Control)
OnInit(EventArgs)	Implementa o método base OnInit(EventArgs) .
OnLoad(EventArgs)	Eleva o Load evento. (Herdado de Control)
OnPreRender(EventArgs)	Implementa o método base OnPreRender(EventArgs) .
OnSendingMail(MailMessageEventArgs)	Eleva o SendingMail evento.
OnSendMailError(SendMailErrorEventArgs)	Aumenta o SendMailError evento quando uma mensagem de email não pode ser enviada ao utilizador.
OnUnload(EventArgs)	Eleva o Unload evento. (Herdado de Control)
OnUserLookupError(EventArgs)	Eleva o UserLookupError evento.
OnVerifyingAnswer(LoginCancelEventArgs)	Eleva o VerifyingAnswer evento.
OnVerifyingUser(LoginCancelEventArgs)	Eleva o VerifyingUser evento.
OpenFile(String)	Recebe um Stream usado para ler um ficheiro. (Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control)
RecreateChildControls()	Recria o filho controla num controlo derivado de CompositeControl. (Herdado de CompositeControl)
RemovedControl(Control)	Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Escreve o CompositeControl conteúdo para o objeto especificado HtmlTextWriter , para exibição no cliente.
RenderBeginTag(HtmlTextWriter)	Renderiza a etiqueta de abertura HTML do controlo ao escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
RenderChildren(HtmlTextWriter)	Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderContents(HtmlTextWriter)	Apresenta o conteúdo do controlo ao autor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control)
RenderControl(HtmlTextWriter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de Control)
RenderEndTag(HtmlTextWriter)	Renderiza a etiqueta HTML de fecho do controlo no escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
ResolveAdapter()	Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control)
ResolveClientUrl(String)	Recebe um URL que pode ser usado pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control)
SaveControlState()	Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor.
SaveViewState()	Guarda qualquer estado que tenha sido modificado após o TrackViewState() método ter sido invocado.
SetDesignModeState(IDictionary)	Implementa o método base IControlDesignerAccessor.SetDesignModeState(IDictionary) .
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TrackViewState()	Implementa o método base TrackViewState() .

evento

Name	Description
AnswerLookupError	Ocorre quando o utilizador insere uma resposta incorreta à pergunta de confirmação da recuperação da palavra-passe.
DataBinding	Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control)
Disposed	Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control)
PreRender	Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control)
SendingMail	Ocorre antes de o utilizador receber uma palavra-passe por email.
SendMailError	Ocorre quando o sistema SMTP Mail gera um erro ao tentar enviar uma mensagem de email.
Unload	Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control)
UserLookupError	Ocorre quando o fornecedor de membros não consegue encontrar o nome de utilizador introduzido pelo utilizador.
VerifyingAnswer	Ocorre quando o utilizador submeteu uma resposta à pergunta de confirmação de recuperação de palavra-passe.
VerifyingUser	Ocorre antes do nome de utilizador ser validado pelo fornecedor de membros.

Implementações de Interface Explícita

Name	Description
IAttributeAccessor.GetAttribute(String)	Recebe um atributo do controlo Web com o nome especificado. (Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Define um atributo do controlo Web ao nome e valor especificados. (Herdado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permite ao designer recriar a coleção de controlos filhos do controlo composto no ambiente de design-time. (Herdado de CompositeControl)
IControlBuilderAccessor.ControlBuilder	Para uma descrição deste elemento, veja ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para uma descrição deste elemento, veja GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para uma descrição deste elemento, veja SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para uma descrição deste elemento, veja SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para uma descrição deste elemento, veja UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para uma descrição deste elemento, veja DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para uma descrição deste elemento, veja HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para uma descrição deste elemento, veja Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para uma descrição deste elemento, veja HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para uma descrição deste elemento, veja AddParsedSubObject(Object). (Herdado de Control)

Métodos da Extensão

Name	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
EnableDynamicData(INamingContainer, Type, Object)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
EnableDynamicData(INamingContainer, Type)	Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado.
FindDataSourceControl(Control)	Devolve a fonte de dados associada ao controlo de dados para o controlo especificado.
FindFieldTemplate(Control, String)	Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado.
FindMetaTable(Control)	Devolve o objeto metatable para o controlo de dados que contém.
GetDefaultValues(INamingContainer)	Obtém a recolha dos valores padrão para o controlo de dados especificado.
GetMetaTable(INamingContainer)	Obtém os metadados da tabela para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado.
SetMetaTable(INamingContainer, MetaTable)	Define os metadados da tabela para o controlo de dados especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se os metadados da tabela estão disponíveis.

Aplica-se a

Ver também

Comentários

Esta página foi útil?