Visão Geral Sobre Controle de Servidor Web do Wizard

Use o controle Wizard para simplificar muitas das tarefas que estão associadas com a criação de uma série de formulários para coletar entrada do usuário.

Esse tópico contém:

  • Cenários

  • Segundo plano

  • Exemplos de código

  • Referência de Classe

Cenários

Coletar entrada do usuário usando formulários é uma tarefa recorrente em desenvolvimento na Web.Um grupo de formulários que é usado para realizar uma tarefa é frequentemente chamado um assistente .

O controle Wizard do ASP.NET simplifica muitas das tarefas associadas à criação de formulários e à coleta de entrada do usuário.O controle Wizard fornece um mecanismo que permite que você facilmente criar, adicionar ou reordenar as etapas.Você pode criar navegação linear e não linear e personalizar o controle da navegação do usuário sem escrever código.

Voltar ao topo

Segundo plano

Criar uma série de formulários interconectados para dividir a coleta de dados é uma prática comum.Você pode fazer isso, gerenciando a navegação entre formulários, a persistência de dados e o gerenciamento de estado em cada etapa.Com o controle Wizard, você usa etapas distintas para coletar dados, que permite aos usuários navegar entre as etapas a seu critério e cria um experiência do usuário mais simples.Como desenvolvedor, você não precisa se preocupar em tornar seus dados persistentes entre páginas porque o controle mantém o estado enquanto o usuário conclui as várias etapas.

Etapas do assistente

O controle Wizard usa as etapas para delimitar diferentes seções de entrada de dados do usuário.A cada etapa dentro do controle é fornecida um StepType para indicar se ele é a etapa inicial, etapa intermediária ou etapa de conclusão.O assistente pode ter tantas etapas intermediárias quanto necessário.Você pode adicionar controles diferentes, como um controle TextBox ou ListBox, para coletar entrada do usuário.Quando você chegar à etapa Complete, todos os dados estarão acessíveis.O exemplo de código a seguir ilustra o controle Wizard com duas etapas.

<asp:Wizard ID="Wizard1" Runat="server">
    <WizardSteps>
        <asp:WizardStep Runat="server" Title="Step 1">
        </asp:WizardStep>
        <asp:WizardStep Runat="server" Title="Step 2">
        </asp:WizardStep>
    </WizardSteps>
</asp:Wizard>

Em cada etapa, você pode adicionar controles e rótulos e aceitar os dados do usuário.O controle Wizard ajudará a gerenciar qual etapa exibir, e ajudará a manter os dados coletados.

Assistente de navegação

O controle Wizard permite tanto navegação linear quanto não linear.O gerenciamento de estado do controle permite que o usuário mova para frente e para trás entre as etapas, e permite que o usuário selecione etapas individuais em qualquer ponto, desde que a barra lateral seja exibida.Você pode personalizar o texto para navegação no elemento asp:Wizard da raiz do controle usando as propriedades StepNextButtonText, StepPreviousButtonText e FinishCompleteButtonText.

<asp:Wizard ID="Wizard1" Runat="server"
  StepNextButtonText=" Next >> "
  StepPreviousButtonText=" << Previous "
  FinishCompleteButtonText=" Done! ">

Personalizando Outros Aspectos de Controle do Assistente

O controle Wizard exibe automaticamente um título e a etapa atual do controle.O título é personalizado com a propriedade HeaderText.Você pode ajustar o modelo do cabeçalho usando a propriedade HeaderTemplate.

Opcionalmente, você pode exibir um botão Cancelar, definindo a propriedade DisplayCancelButton como true.

A propriedade NavigationButtonStyle do controle Wizard oferece uma maneira fácil para definir um estilo comum para todos os botões, enquanto fornece a flexibilidade para personalizar cada botão individualmente.A propriedade NavigationButtonStyle se aplica a todos os botões desenhados.No entanto, você pode substituir esse estilo definindo a propriedade individual de estilo do botão.

Modelos de navegação

O controle Wizard suporta modelos que permitem que você personalizar a interface do controle com as propriedades StartNavigationTemplate, FinishNavigationTemplate, StepNavigationTemplate e SideBarTemplate.

Assistente para eventos de controle

Você pode personalizar o comportamento do controle Wizard usando código e eventos personalizados.

Por exemplo, você pode interceptar o evento NextButtonClick, que é gerado quando o usuário clica no botão Avançar e captura os dados da etapa atual.O parâmetro WizardNavigationEventArgs passado para este evento contém as propriedades CurrentStepIndex e NextStepIndex, permitindo que você personalize o comportamento do controle com base nas etapas atual e próxima, ou cancelar a navegação quando o botão Avançar é clicado.

Da mesma forma, você pode personalizar o comportamento dos botões Voltar e Finalizar usando os eventos PreviousButtonClick e FinishButtonClick.Ou você pode executar limpeza quando o botão Cancelar é clicado, usando o evento CancelButtonClick.

Voltar ao topo

Exemplos de código

Demonstra Passo a passo: Criando um controle ASP.NET assistente básico

Demonstra Passo a passo: Usar avançado do controle assistente do ASP.NET

Voltar ao topo

Referência de Classe

A tabela seguinte lista as classes chave que estão relacionados ao controle Wizard.

Membro

Descrição

Wizard

A classe principal para o controle.

WizardNavigationEventArgs

Fornece os dados que são necessários para os diversos eventos de navegação em um controle Wizard.

WizardNavigationEventHandler

Representa o método que manipulará eventos de navegação em um controle Wizard.

WizardStep

Representa uma etapa básica que é exibida em um controle Wizard.

WizardStepCollection

Representa uma coleção de objetos WizardStep que contenham a interface do usuário para cada etapa, conforme definido pelo desenvolvedor de página.

WizardStepType

Especifica os tipos de IU de navegação que podem ser exibidas para uma etapa em um controle Wizard.

Voltar ao topo

Consulte também

Referência

CreateUserWizard