Partilhar via

WizardStepBase.AllowReturn Propriedade

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 subsequente em uma WizardStepCollection coleção.

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 o uso da AllowReturn propriedade para impedir que o usuário retorne a uma etapa no Wizard controle depois que ele tiver sido acessado. No exemplo, a Step1 etapa tem sua AllowReturn propriedade definida como false. 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 como false, 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 é permitir que um usuário retorne a uma etapa após a conclusão, pois 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 de salvos, os dados salvos poderão ser corrompidos. Ao definir a AllowReturn propriedade como false, depois que o usuário tiver deixado uma etapa, ele não poderá retornar a ela e alterar os valores.

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 .

Scenario Comportamento
Linear: a Etapa1 foi AllowReturn definida 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 false Etapa1 foi AllowReturn definida 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 etapa 2 foi AllowReturn definida como false , DisplaySideBar está definida como true, e um usuário clica no botão Barra Lateral. Nenhum botão é desabilitado automaticamente na barra lateral quando AllowReturn definido como false. 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 definida para false quando você usar um modelo para navegação. O botão Anterior deve ser opcional no modelo.
Usando o Designer do Visual Studio e ActiveStepIndex : O controle tem cinco etapas, você está trabalhando na etapa 4 e executa a página. Quando a etapa 4 é a ActiveStepIndex, o botão Anterior é renderizado. O botão Anterior só está oculto para StepType definir Step quando a etapa anterior no histórico tiver AllowReturn sido definida como false. Como a etapa 4 é renderizada primeiro e não há etapas no histórico, o botão Anterior não está oculto.
Etapa iniciar e navegação não linear: um usuário visita a etapa 3 e a etapa 4 e, em seguida, a etapa 1 que foi StepType definida como Start. O assistente não adiciona um botão Anterior quando o StepType está definido Start , independentemente de como o usuário navega para essa etapa.
Mesma etapa no histórico: um usuário visita a Step etapa 3 na qual StepType está definido 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 o destino com base na "etapa diferente" no histórico.

Observação

Quando a AllowReturn propriedade é definida como false, mas a DisplaySideBar propriedade do controle WizardStepBase pai é definida como true, 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 Peles.

Aplica-se a

Confira também