WizardStepBase.AllowReturn Propriedade

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtém ou define um valor que indica se o usuário tem permissão para retornar à etapa atual de uma etapa posterior em uma coleção WizardStepCollection.

public:
 virtual property bool AllowReturn { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
public virtual bool AllowReturn { get; set; }
[<System.Web.UI.Themeable(false)>]
member this.AllowReturn : bool with get, set
Public Overridable Property AllowReturn As Boolean

Valor da propriedade

Boolean

true se o usuário tiver permissão para retornar à etapa atual; caso contrário, false. O valor padrão é true.

Atributos
ThemeableAttribute

Exemplos

O exemplo a seguir demonstra como usar a AllowReturn propriedade para impedir que o usuário retorne a uma etapa no Wizard controle depois de ter sido acessado. No exemplo, a Step1 etapa tem sua AllowReturn propriedade definida falsecomo . Depois que o usuário sair da Step1 etapa, nenhum botão Anterior será exibido na Step2 etapa.

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

</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:Wizard id="Wizard1" 
        runat="server"
    displaysidebar="false" >
        <WizardSteps>
          <asp:WizardStep id="WizardStep1" 
            title="Step 1" 
            allowreturn="false"
            runat="server">
            You are currently on Step 1.
          </asp:WizardStep>
          <asp:WizardStep id="WizardStep2" 
            title="Step 2" 
            runat="server">
            You are currently on Step 2.
          </asp:WizardStep>
          <asp:WizardStep id="WizardStep3" 
            title="Step 3" 
            runat="server">
            You are currently on Step 3.
          </asp:WizardStep>
        </WizardSteps>
        <HeaderTemplate>
          <b>WizardStepBase AllowReturn Example</b>
        </HeaderTemplate>
      </asp:Wizard>
    </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">

</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:Wizard id="Wizard1" 
        runat="server"
    displaysidebar="false" >
        <WizardSteps>
          <asp:WizardStep id="WizardStep1" 
            title="Step 1" 
            allowreturn="false"
            runat="server">
            You are currently on Step 1.
          </asp:WizardStep>
          <asp:WizardStep id="WizardStep2" 
            title="Step 2" 
            runat="server">
            You are currently on Step 2.
          </asp:WizardStep>
          <asp:WizardStep id="WizardStep3" 
            title="Step 3" 
            runat="server">
            You are currently on Step 3.
          </asp:WizardStep>
        </WizardSteps>
        <HeaderTemplate>
          <b>WizardStepBase AllowReturn Example</b>
        </HeaderTemplate>
      </asp:Wizard>
    </form>
  </body>
</html>

Comentários

A AllowReturn propriedade pode ser usada para impor a navegação linear em um Wizard controle . Se cada etapa tiver sua AllowReturn propriedade definida falsecomo , o usuário não poderá retornar a uma etapa depois de ter sido acessado. Um cenário em que você pode usar essa funcionalidade é não permitir que um usuário retorne a uma etapa após a conclusão porque você está mantendo os dados em um banco de dados à medida que cada etapa é concluída. Se você salvar os dados após cada etapa e permitir que o usuário retorne a uma etapa e altere as informações depois que elas forem salvas, os dados salvos poderão ser corrompidos. Ao definir a AllowReturn propriedade falsecomo , depois que o usuário sair de uma etapa, ele não poderá retornar a ela e alterar nenhum valor.

A AllowReturn propriedade determina como e quando o botão Anterior não é renderizado. A tabela a seguir descreve o comportamento de renderização do botão Anterior .

Cenário Comportamento
Linear: a Etapa 1 foi AllowReturn definida como false e a ação do usuário vai para a etapa 2. A etapa 2 não exibe o botão Anterior .
Não Linear: a Etapa 1 foi AllowReturn definida false como e a ação do usuário vai para a etapa 3. A etapa 3 não exibe o botão Anterior .
Botões da Barra Lateral: a false Etapa 2 foi AllowReturn definida como , DisplaySideBar está definida truecomo e um usuário clica no botão Barra Lateral. Nenhum botão é desabilitado automaticamente na barra lateral quando AllowReturn é definido falsecomo . Se um usuário clicar no botão, a ação será ignorada.
Linear & Não Linear com Modelo Personalizado: a etapa tem um modelo de navegação personalizado. Nenhuma ocultação ou exibição automática ocorrerá se AllowReturn estiver definido false como quando você usar um modelo para navegação. O botão Anterior deve ser opcional no modelo.
Usando o Visual Studio Designer e ActiveStepIndex : o controle tem cinco etapas, você está trabalhando na etapa 4 e executa a página. Quando a etapa 4 é o ActiveStepIndex, o botão Anterior é renderizado. O botão Anterior só fica oculto para definido Step como StepType quando a etapa anterior no histórico tiver AllowReturn definido falsecomo . Como a etapa 4 é renderizada primeiro e não há etapas no histórico, o botão Anterior não está oculto.
Iniciar Etapa e Navegação Não Linear: um usuário visita as etapas 3 e 4 e, em seguida, a etapa 1, que foi StepType definida Startcomo . O assistente não adiciona um botão Anterior quando o StepType é definido Start como, independentemente de como o usuário navega para essa etapa.
Mesma Etapa no Histórico: um usuário visita a etapa 3 em que StepType está definido Step como e o usuário não confirma suas ações. Em seguida, eles clicam no botão anterior na etapa 3. O controle do assistente verifica se a etapa Anterior no histórico é a "mesma" etapa em que o usuário está atualmente. Se a etapa for a mesma, o controle do assistente examinará novamente o histórico para determinar a etapa "diferente" anterior e baseará a exibição do botão Anterior e do destino com base na "etapa diferente" no histórico.

Observação

Quando a AllowReturn propriedade é definida falsecomo , mas a DisplaySideBar propriedade do controle pai de WizardStepBase é definida truecomo , clicar em um botão na área da barra lateral não tem efeito. A área da barra lateral geralmente é exibida para fornecer navegação não linear, portanto, se você não estiver usando a funcionalidade de navegação não linear, convém definir a DisplaySideBar propriedade como false.

Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Capas.

Aplica-se a

Confira também