Compartilhar via


PasswordRecovery Classe

Definição

Fornece elementos de interface do usuário que permitem que um usuário recupere ou redefina uma senha perdida e a receba 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
Atributos

Exemplos

O exemplo de código a seguir demonstra o uso do PasswordRecovery controle.

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

Comentários

Neste tópico:

Introdução

O PasswordRecovery controle auxilia os usuários que esqueceram suas senhas. Ele permite que um usuário solicite uma mensagem de email contendo uma nova senha ou a senha já associada ao nome de usuário.

Observação

O PasswordRecovery controle da Web usa serviços de email da Internet para enviar senhas recuperadas ou novas aos usuários. Há riscos inerentes à segurança com o envio de senhas por email. Você deve determinar se esses riscos de segurança são aceitáveis para seu site.

Observação

Se você não estiver familiarizado com o conjunto de controles de logon disponível no ASP.NET, consulte ASP.NET Visão geral dos controles de logon antes de continuar. Para obter uma lista de outros tópicos relacionados a controles de logon e associação, consulte Gerenciando usuários usando associação.

Os usuários só podem recuperar senhas quando o provedor de associação definido na propriedade dá suporte a MembershipProvider texto claro ou senhas criptografadas. Como as senhas com hash não podem ser recuperadas, os usuários em sites que usam senhas com hash só podem redefinir suas senhas.

Importante

Aceitar a entrada do usuário é uma ameaça à segurança em potencial. Usuários mal-intencionados podem enviar dados destinados a expor vulnerabilidades ou executar programas que tentam senhas geradas. Para melhorar a segurança ao trabalhar com a entrada do usuário, você deve usar os recursos de validação do controle e proteger todos os provedores de dados configurados para o controle. Para obter mais informações, consulte Proteção de controles de logon, práticas básicas de segurança para aplicativos Web e proteção da associação.

Observação

O PasswordRecovery controle pode ser usado quando um usuário de associação não foi aprovado (MembershipUser.IsApproved está definido como false), mas não pode ser usado quando um usuário de associação foi bloqueado (MembershipUser.IsLockedOut está definido como true).

A mensagem de email é enviada usando a MailDefinition classe. Para poder enviar emails aos usuários, você deve configurar um servidor de email no arquivo de Web.config do aplicativo. Você pode alterar o conteúdo do email enviado aos usuários definindo uma mensagem personalizada na MailDefinition propriedade.

Observação

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

Visões

O PasswordRecovery controle tem três estados ou exibições:

  • Modo de exibição Nome de Usuário – Solicita ao usuário o nome de usuário registrado.

  • Exibição de pergunta – exige que o usuário forneça a resposta a uma pergunta armazenada para redefinir a senha.

  • Exibição de êxito – informa ao usuário se a recuperação ou redefinição de senha foi bem-sucedida.

O PasswordRecovery controle exibe o modo de exibição Pergunta somente quando o provedor de associação definido na propriedade dá suporte à MembershipProvider pergunta e à resposta de senha.

A tabela a seguir lista cada propriedade de estilo do PasswordRecovery controle e indica qual exibição ele afeta.

Propriedade Modo de exibição UserName Exibição de perguntas Exibição de êxito
SubmitButtonStyle Sim Sim Sim
FailureTextStyle Sim Sim No
HyperLinkStyle Sim Sim No
InstructionTextStyle Sim Sim No
LabelStyle Sim Sim No
SuccessTextStyle No No Sim
TextBoxStyle Sim Sim No
TitleTextStyle Sim Sim Sim

Estilos e modelos

Você pode usar um amplo conjunto de propriedades de estilo para personalizar a aparência do PasswordRecovery controle. Como alternativa, você pode aplicar modelos personalizados às três exibições se precisar de controle total sobre a aparência do controle. Você pode usar as propriedades e UserNameTemplate as QuestionTemplateSuccessTemplate propriedades para criar modelos para essas exibições. Se você definir um modelo para uma exibição, as propriedades de estilo não PasswordRecovery terão efeito.

A tabela a seguir lista as PasswordRecovery propriedades de estilo de controle e explica qual elemento de interface do usuário cada propriedade de estilo afeta. Para obter uma lista de quais propriedades cada estilo se aplica, consulte a documentação das propriedades de estilo individuais.

Propriedade Style Elemento de interface do usuário afetado
SubmitButtonStyle Enviar botões em todos os modos de exibição.
FailureTextStyle Texto de erro exibido para o usuário.
HyperLinkStyle Links para outras páginas.
InstructionTextStyle Texto instrucional na página que informa aos usuários como usar o controle.
LabelStyle Rótulos para todos os campos de entrada, como caixas de texto.
TextBoxStyle Campos de entrada de texto.
TitleTextStyle Texto do título para cada exibição.
SuccessTextStyle Texto exibido para o usuário quando a tentativa de recuperação ou redefinição de senha for bem-sucedida.

A tabela a seguir lista quais propriedades de modelo se aplicam a cada exibição no PasswordRecovery controle. Para obter uma lista dos controles que você deve definir em cada modelo, consulte a documentação das propriedades de modelo individuais.

View Propriedade Template
UserName UserNameTemplate
Pergunta QuestionTemplate
Êxito SuccessTemplate

Quando o PasswordRecovery controle não é personalizado com modelos, a AccessKey propriedade do PasswordRecovery controle se aplica à primeira caixa de texto no controle e à TabIndex propriedade, que é aplicada a todas as caixas de texto do controle. Se o PasswordRecovery controle for personalizado com modelos, a AccessKey propriedade e a TabIndex propriedade serão ignoradas. Nesse caso, defina a AccessKey propriedade e a TabIndex propriedade de cada controle filho de modelo diretamente.

PasswordRecovery as propriedades de controle 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 controle selecionará todas as alterações feitas pelo usuário final por meio do TextChanged evento disparado pelas caixas de texto.

Agrupamentos de validação

O PasswordRecovery controle cria um grupo de validação para todos os validadores de campo necessários no controle para que outros controles de entrada na página não sejam afetados pela validação do PasswordRecovery controle. Por padrão, a ID propriedade do PasswordRecovery controle é usada como o nome do grupo de validação. Por exemplo, um PasswordRecovery controle com a ID "PasswordRecovery1" usará um nome de grupo de validação de "PasswordRecovery1". Se você quiser que o PasswordRecovery controle participe de outro grupo de validação, você deve definir o modelo do controle.

Aplicando estilos CSS

O PasswordRecovery controle permite especificar regras de estilo CSS na marcação. Se você usar modelos para personalizar a aparência do PasswordRecovery controle, poderá especificar estilos CSS na marcação nos modelos. Nesse caso, nenhuma tabela externa extra é necessária. Você pode impedir que a tabela seja renderizada definindo a RenderOuterTable propriedade como false.

Accessibility

Para obter informações sobre como configurar esse controle para que ele gere marcação em conformidade com os padrões de acessibilidade, consulte Acessibilidade no Visual Studio e ASP.NET e ASP.NET Controles 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

Nome Description
PasswordRecovery()

Inicializa uma nova instância da classe PasswordRecovery.

Campos

Nome Description
SubmitButtonCommandName

Representa o comando a ser executado quando o botão Enviar é clicado.

Propriedades

Nome Description
AccessKey

Obtém ou define a chave de acesso que permite navegar rapidamente até o controle do servidor Web.

(Herdado de WebControl)
Adapter

Obtém o adaptador específico do navegador para o controle.

(Herdado de Control)
Answer

Obtém a resposta para a pergunta de confirmação de recuperação de senha inserida pelo usuário.

AnswerLabelText

Obtém ou define o texto do rótulo da caixa de texto de resposta de confirmação de senha.

AnswerRequiredErrorMessage

Obtém ou define a mensagem de erro exibida para o usuário quando a caixa de texto Responder estiver em branco.

AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo ao aplicativo do Page objeto ou UserControl que contém esse controle.

(Herdado de Control)
Attributes

Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades no controle.

(Herdado de WebControl)
BackColor

Obtém ou define a cor da tela de fundo do controle do servidor Web.

(Herdado de WebControl)
BindingContainer

Obtém o controle que contém a associação de dados desse controle.

(Herdado de Control)
BorderColor

Obtém ou define a cor da borda do controle Web.

(Herdado de WebControl)
BorderPadding

Obtém ou define a quantidade de preenchimento dentro das bordas do PasswordRecovery controle.

BorderStyle

Obtém ou define o estilo de borda do controle do servidor Web.

(Herdado de WebControl)
BorderWidth

Obtém ou define a largura da borda do controle do servidor Web.

(Herdado de WebControl)
ChildControlsCreated

Obtém um valor que indica se os controles filho do controle do servidor foram criados.

(Herdado de Control)
ClientID

Obtém a ID de controle para marcação HTML gerada por ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da ClientID propriedade.

(Herdado de Control)
ClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na ClientID propriedade.

(Herdado de Control)
Context

Obtém o HttpContext objeto associado ao controle do servidor para a solicitação da Web atual.

(Herdado de Control)
Controls

Obtém um ControlCollection objeto que representa os controles filho em um CompositeControl.

(Herdado de CompositeControl)
ControlStyle

Obtém o estilo do controle do servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
ControlStyleCreated

Obtém um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
CssClass

Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente.

(Herdado de WebControl)
DataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataItemContainer.

(Herdado de Control)
DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataKeysControl.

(Herdado de Control)
DesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.

(Herdado de Control)
Enabled

Obtém ou define um valor que indica se o controle do servidor Web está habilitado.

(Herdado de WebControl)
EnableTheming

Obtém ou define um valor que indica se os temas se aplicam a esse controle.

(Herdado de WebControl)
EnableViewState

Obtém ou define um valor que indica se o controle do servidor persiste seu estado de exibição e o estado de exibição de todos os controles filho que ele contém, para o cliente solicitante.

(Herdado de Control)
Events

Obtém uma lista de representantes do manipulador de eventos para o controle. Esta propriedade é somente para 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 controle.

Font

Obtém as propriedades de fonte associadas ao controle do servidor Web.

(Herdado de WebControl)
ForeColor

Obtém ou define a cor do primeiro plano (normalmente a cor do texto) do controle do servidor Web.

(Herdado de WebControl)
GeneralFailureText

Obtém ou define a mensagem de erro a ser exibida quando há um problema com o provedor de associação para o PasswordRecovery controle.

HasAttributes

Obtém um valor que indica se o controle tem atributos definidos.

(Herdado de WebControl)
HasChildViewState

Obtém um valor que indica se os controles filho do controle do servidor atual têm configurações de estado de exibição salvas.

(Herdado de Control)
Height

Obtém ou define a altura do controle do servidor Web.

(Herdado de WebControl)
HelpPageIconUrl

Obtém ou define a URL de uma imagem a ser exibida ao lado do link para a página ajuda.

HelpPageText

Obtém ou define o texto do link para a página ajuda de recuperação de senha.

HelpPageUrl

Obtém ou define a URL da página ajuda de recuperação de senha.

HyperLinkStyle

Obtém uma referência a uma coleção de propriedades que definem a aparência de hiperlinks no PasswordRecovery controle.

ID

Obtém ou define o identificador programático atribuído ao controle do servidor.

(Herdado de Control)
IdSeparator

Obtém o caractere usado para separar identificadores de controle.

(Herdado de Control)
InstructionTextStyle

Obtém uma referência a uma coleção de propriedades de estilo que definem a aparência do texto explicativo no PasswordRecovery controle.

IsChildControlStateCleared

Obtém um valor que indica se os controles contidos nesse controle têm estado de controle.

(Herdado de Control)
IsEnabled

Obtém um valor que indica se o controle está habilitado.

(Herdado de WebControl)
IsTrackingViewState

Obtém um valor que indica se o controle do servidor está salvando alterações em seu estado de exibição.

(Herdado de Control)
IsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.

(Herdado de Control)
LabelStyle

Obtém uma referência a uma coleção de propriedades de estilo que definem a aparência de rótulos de caixa de texto no PasswordRecovery controle.

LoadViewStateByID

Obtém um valor que indica se o controle participa no carregamento de seu estado de exibição ID em vez de índice.

(Herdado de Control)
MailDefinition

Obtém uma referência a uma coleção de propriedades que definem as características das mensagens de email usadas para enviar senhas novas ou recuperadas aos usuários.

MembershipProvider

Obtém ou define o provedor de associação usado para pesquisar informações do usuário.

NamingContainer

Obtém uma referência ao contêiner de nomenclatura do controle de servidor, que cria um namespace exclusivo para diferenciar entre controles 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 controle do servidor.

(Herdado de Control)
Parent

Obtém uma referência ao controle pai do controle do servidor na hierarquia de controle de página.

(Herdado de Control)
Question

Obtém a pergunta de confirmação de recuperação de senha estabelecida pelo usuário no site.

QuestionFailureText

Obtém ou define o texto a ser exibido quando a resposta do usuário à pergunta de confirmação de recuperação de senha não corresponder à resposta armazenada no armazenamento de dados do site.

QuestionInstructionText

Obtém ou define o texto a ser exibido no modo de exibição Pergunta para instruir o usuário a responder à pergunta de confirmação de recuperação de senha.

QuestionLabelText

Obtém ou define o texto do rótulo da Question caixa de texto.

QuestionTemplate

Obtém ou define o modelo usado para exibir o modo de exibição Question do PasswordRecovery controle.

QuestionTemplateContainer

Obtém o contêiner que um PasswordRecovery controle usou para criar uma instância do QuestionTemplate modelo. Essa propriedade fornece acesso programático a controles filho.

QuestionTitleText

Obtém ou define o título para o modo de exibição Question do PasswordRecovery controle.

RenderingCompatibility

Obtém um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível.

(Herdado de Control)
RenderOuterTable

Obtém ou define um valor que indica se o controle inclui HTML renderizado em um table elemento para aplicar estilos embutidos.

Site

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizado em uma superfície de design.

(Herdado de Control)
SkinID

Obtém ou define a pele a ser aplicada ao controle.

(Herdado de WebControl)
Style

Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle do servidor Web.

(Herdado de WebControl)
SubmitButtonImageUrl

Obtém ou define a URL de uma imagem a ser usada como o botão Enviar.

SubmitButtonStyle

Obtém uma referência a uma coleção de propriedades que definem a aparência dos botões Enviar no PasswordRecovery controle.

SubmitButtonText

Obtém ou define o texto do botão que envia o formulário.

SubmitButtonType

Obtém ou define o tipo de botão Enviar a ser usado ao renderizar o PasswordRecovery controle.

SuccessPageUrl

Obtém ou define a URL da página a ser exibida depois de enviar uma senha com êxito.

SuccessTemplate

Obtém ou define o modelo usado para exibir a exibição Êxito do PasswordRecovery controle.

SuccessTemplateContainer

Obtém o contêiner que um PasswordRecovery controle usou para criar uma instância do SuccessTemplate modelo. Essa propriedade fornece acesso programático a controles filho.

SuccessText

Obtém ou define o texto a ser exibido depois de enviar uma senha com êxito.

SuccessTextStyle

Obtém uma referência a uma coleção de propriedades de estilo que definem a aparência do texto exibido na exibição Êxito do PasswordRecovery controle.

SupportsDisabledAttribute

Obtém um valor que indica se o controle deve definir o disabled atributo do elemento HTML renderizado como "desabilitado" quando a propriedade do IsEnabled controle é false.

(Herdado de CompositeControl)
TabIndex

Obtém ou define o índice de tabulação do controle do servidor Web.

(Herdado de WebControl)
TagKey

Obtém o HtmlTextWriterTag valor que corresponde a um PasswordRecovery controle.

TagName

Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
TemplateControl

Obtém ou define uma referência ao modelo que contém esse controle.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle de servidor atual.

(Herdado de Control)
TextBoxStyle

Obtém uma referência a uma coleção de propriedades de estilo que definem a aparência das caixas de texto no PasswordRecovery controle.

TextLayout

Obtém ou define um valor que especifica se o PasswordRecovery controle deve ser exibido em um layout 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 controle.

ToolTip

Obtém ou define o texto exibido quando o ponteiro do mouse passa o mouse sobre o controle do servidor Web.

(Herdado de WebControl)
UniqueID

Obtém o identificador exclusivo e hierarquicamente qualificado para o controle do servidor.

(Herdado de Control)
UserName

Obtém ou define o texto que aparece na caixa de texto Nome de Usuário.

UserNameFailureText

Obtém ou define o texto exibido quando o nome de usuário inserido pelo usuário não é um nome de usuário válido para o site.

UserNameInstructionText

Obtém ou define o texto a ser exibido no modo de exibição UserName do PasswordRecovery controle para instruir o usuário a inserir um nome de usuário.

UserNameLabelText

Obtém ou define o texto do rótulo para a caixa de texto Nome de Usuário.

UserNameRequiredErrorMessage

Obtém ou define a mensagem de erro exibida quando um usuário deixa a caixa de texto Nome de Usuário vazia.

UserNameTemplate

Obtém ou define o modelo usado para exibir a exibição UserName do PasswordRecovery controle.

UserNameTemplateContainer

Obtém o contêiner que um PasswordRecovery controle usou para criar uma instância do UserNameTemplate modelo. Essa propriedade fornece acesso programático a controles filho.

UserNameTitleText

Obtém ou define o título para a exibição UserName do PasswordRecovery controle.

ValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador em busca de valores potencialmente perigosos.

(Herdado de Control)
ValidatorTextStyle

Obtém uma referência a uma coleção de Style propriedades que definem a aparência de mensagens de erro associadas a qualquer validação de entrada usada pelo PasswordRecovery controle.

ViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página.

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o StateBag objeto não diferencia maiúsculas de minúsculas.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo de estado de exibição desse controle.

(Herdado de Control)
Visible

Obtém ou define um valor que indica se um controle de servidor é renderizado como interface do usuário na página.

(Herdado de Control)
Width

Obtém ou define a largura do controle do servidor Web.

(Herdado de WebControl)

Métodos

Nome Description
AddAttributesToRender(HtmlTextWriter)

Adiciona atributos HTML e estilos que precisam ser renderizados ao especificado HtmlTextWriterTag. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
AddedControl(Control, Int32)

Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto.

(Herdado de Control)
AddParsedSubObject(Object)

Notifica o controle do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto do controle do ControlCollection servidor.

(Herdado de Control)
ApplyStyle(Style)

Copia todos os elementos nãoblank do estilo especificado para o controle da Web, substituindo quaisquer elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos de página ao controle.

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento em tempo de design dos dados de renderização.

(Herdado de Control)
BuildProfileTree(String, Boolean)

Coleta informações sobre o controle do servidor e o Trace entrega na propriedade a ser exibida quando o rastreamento está habilitado para a página.

(Herdado de Control)
ClearCachedClientID()

Define o valor armazenado em ClientID cache como null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle do servidor.

(Herdado de Control)
ClearChildState()

Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle do servidor.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle do servidor.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a ClientIDMode propriedade da instância de controle atual e de qualquer controle filho como Inherit.

(Herdado de Control)
CopyBaseAttributes(WebControl)

Copia as propriedades não encapsuladas pelo Style objeto do controle de servidor Web especificado para o controle do servidor Web do qual esse método é chamado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
CreateChildControls()

Cria os controles individuais que compõem o PasswordRecovery controle.

CreateControlCollection()

Cria um novo ControlCollection objeto para manter os controles filho (literal e servidor) do controle do servidor.

(Herdado de Control)
CreateControlStyle()

Cria o objeto de estilo que é usado internamente pela WebControl classe para implementar todas as propriedades relacionadas ao estilo. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
DataBind()

Associa uma fonte de dados a CompositeControl todos os seus controles filho.

(Herdado de CompositeControl)
DataBind(Boolean)

Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho com uma opção para gerar o DataBinding evento.

(Herdado de Control)
DataBindChildren()

Associa uma fonte de dados aos controles filho do controle do servidor.

(Herdado de Control)
Dispose()

Permite que um controle de servidor execute a limpeza final antes de ser liberado da memória.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento em tempo de design dos dados de renderização.

(Herdado de Control)
EnsureChildControls()

Determina se o controle do servidor contém controles filho. Se isso não acontecer, ele criará controles filho.

(Herdado de Control)
EnsureID()

Cria um identificador para controles 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 o contêiner de nomenclatura atual para um controle de servidor com o especificado id e um inteiro, especificado no parâmetro, que pathOffset ajuda na pesquisa. Você não deve substituir essa versão do FindControl método.

(Herdado de Control)
FindControl(String)

Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro especificado id .

(Herdado de Control)
Focus()

Define o foco de entrada como um controle.

(Herdado de Control)
GetDesignModeState()

Obtém dados de tempo de design para um controle.

(Herdado de Control)
GetHashCode()

Serve como a função de hash padrão.

(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 a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.

(Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.

(Herdado de Control)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da UniqueID propriedade do controle especificado.

(Herdado de Control)
HasControls()

Determina se o controle do servidor contém controles filho.

(Herdado de Control)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou quaisquer controles filho.

(Herdado de Control)
IsLiteralContent()

Determina se o controle 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, absoluto ou relativo, é mapeado.

(Herdado de Control)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
MergeStyle(Style)

Copia todos os elementos nãoblank do estilo especificado para o controle da Web, mas não substituirá nenhum elemento de estilo existente do controle. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
OnAnswerLookupError(EventArgs)

Aciona o evento AnswerLookupError.

OnBubbleEvent(Object, EventArgs)

Determina se o evento para o controle do servidor é passado para a hierarquia de controle do servidor de interface do usuário da página.

OnDataBinding(EventArgs)

Aciona o evento DataBinding.

(Herdado de Control)
OnInit(EventArgs)

Implementa o método base OnInit(EventArgs) .

OnLoad(EventArgs)

Aciona o evento Load.

(Herdado de Control)
OnPreRender(EventArgs)

Implementa o método base OnPreRender(EventArgs) .

OnSendingMail(MailMessageEventArgs)

Aciona o evento SendingMail.

OnSendMailError(SendMailErrorEventArgs)

Aciona o SendMailError evento quando uma mensagem de email não pode ser enviada ao usuário.

OnUnload(EventArgs)

Aciona o evento Unload.

(Herdado de Control)
OnUserLookupError(EventArgs)

Aciona o evento UserLookupError.

OnVerifyingAnswer(LoginCancelEventArgs)

Aciona o evento VerifyingAnswer.

OnVerifyingUser(LoginCancelEventArgs)

Aciona o evento VerifyingUser.

OpenFile(String)

Obtém um Stream usado para ler um arquivo.

(Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)

Atribui todas as fontes do evento e suas informações ao pai do controle.

(Herdado de Control)
RecreateChildControls()

Recria os controles filho em um controle derivado de CompositeControl.

(Herdado de CompositeControl)
RemovedControl(Control)

Chamado depois que um controle filho é removido da Controls coleção do Control objeto.

(Herdado de Control)
Render(HtmlTextWriter)

Grava o CompositeControl conteúdo no objeto especificado HtmlTextWriter , para exibição no cliente.

RenderBeginTag(HtmlTextWriter)

Renderiza a marca de abertura HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
RenderChildren(HtmlTextWriter)

Gera o conteúdo dos filhos de um controle de servidor para um objeto fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente.

(Herdado de Control)
RenderContents(HtmlTextWriter)

Renderiza o conteúdo do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera conteúdo de controle de servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter .

(Herdado de Control)
RenderControl(HtmlTextWriter)

O servidor de saída controla o conteúdo de um objeto fornecido HtmlTextWriter e armazena informações de rastreamento sobre o controle se o rastreamento estiver habilitado.

(Herdado de Control)
RenderEndTag(HtmlTextWriter)

Renderiza a marca de fechamento HTML do controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
ResolveAdapter()

Obtém o adaptador de controle responsável por renderizar o controle especificado.

(Herdado de Control)
ResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL em uma que é utilizável no cliente solicitante.

(Herdado de Control)
SaveControlState()

Salva as alterações de estado do controle do servidor que ocorreram desde o momento em que a página foi postada de volta no servidor.

SaveViewState()

Salva qualquer estado modificado após a invocação do TrackViewState() método.

SetDesignModeState(IDictionary)

Implementa o método base IControlDesignerAccessor.SetDesignModeState(IDictionary) .

SetRenderMethodDelegate(RenderMethod)

Atribui um representante do manipulador de eventos para renderizar o controle do servidor e seu conteúdo em seu controle pai.

(Herdado de Control)
SetTraceData(Object, Object, Object)

Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor dos dados de rastreamento.

(Herdado de Control)
SetTraceData(Object, Object)

Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando a chave de dados de rastreamento e o valor dos dados de rastreamento.

(Herdado de Control)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TrackViewState()

Implementa o método base TrackViewState() .

Eventos

Nome Description
AnswerLookupError

Ocorre quando o usuário insere uma resposta incorreta para a pergunta de confirmação de recuperação de senha.

DataBinding

Ocorre quando o controle do servidor é associado a uma fonte de dados.

(Herdado de Control)
Disposed

Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida do controle do servidor quando uma página ASP.NET é solicitada.

(Herdado de Control)
Init

Ocorre quando o controle do servidor é inicializado, que é a primeira etapa em seu ciclo de vida.

(Herdado de Control)
Load

Ocorre quando o controle do servidor é carregado no Page objeto.

(Herdado de Control)
PreRender

Ocorre depois que o Control objeto é carregado, mas antes da renderização.

(Herdado de Control)
SendingMail

Ocorre antes que o usuário envie uma senha por email.

SendMailError

Ocorre quando o sistema de email SMTP lança um erro ao tentar enviar uma mensagem de email.

Unload

Ocorre quando o controle do servidor é descarregado da memória.

(Herdado de Control)
UserLookupError

Ocorre quando o provedor de associação não consegue localizar o nome de usuário inserido pelo usuário.

VerifyingAnswer

Ocorre quando o usuário envia uma resposta para a pergunta de confirmação de recuperação de senha.

VerifyingUser

Ocorre antes que o nome de usuário seja validado pelo provedor de associação.

Implantações explícitas de interface

Nome Description
IAttributeAccessor.GetAttribute(String)

Obtém um atributo do controle Web com o nome especificado.

(Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Define um atributo do controle Web como o nome e o valor especificados.

(Herdado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Permite que um designer recrie a coleção de controles filho do controle composto no ambiente de tempo de design.

(Herdado de CompositeControl)
IControlBuilderAccessor.ControlBuilder

Para obter uma descrição deste membro, consulte ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição deste membro, consulte GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição deste membro, consulte SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição deste membro, consulte SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição deste membro, consulte UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição deste membro, consulte DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição deste membro, consulte HasDataBindings.

(Herdado de Control)
IExpressionsAccessor.Expressions

Para obter uma descrição deste membro, consulte Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição deste membro, consulte HasExpressions.

(Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição deste membro, consulte AddParsedSubObject(Object).

(Herdado de Control)

Métodos de Extensão

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

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

EnableDynamicData(INamingContainer, Type, Object)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

EnableDynamicData(INamingContainer, Type)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

FindDataSourceControl(Control)

Retorna a fonte de dados associada ao controle de dados para o controle especificado.

FindFieldTemplate(Control, String)

Retorna o modelo de campo para a coluna especificada no contêiner de nomenclatura do controle especificado.

FindMetaTable(Control)

Retorna o objeto metatável para o controle de dados que contém.

GetDefaultValues(INamingContainer)

Obtém a coleção dos valores padrão para o controle de dados especificado.

GetMetaTable(INamingContainer)

Obtém os metadados da tabela para o controle de dados especificado.

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

Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable, Object)

Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable)

Define os metadados da tabela para o controle de dados especificado.

TryGetMetaTable(INamingContainer, MetaTable)

Determina se os metadados da tabela estão disponíveis.

Aplica-se a

Confira também