WizardStepBase.AllowReturn Propriedade

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.

Recebe ou define um valor que indica se o utilizador pode regressar ao passo atual a partir de um passo subsequente numa 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 de Propriedade

Boolean

true se o utilizador puder regressar ao passo atual; caso contrário, false. O valor predefinido é true.

Atributos: ThemeableAttribute

Exemplos

O exemplo seguinte demonstra a utilização da AllowReturn propriedade para impedir que o utilizador volte a um passo no Wizard controlo depois de este ter sido acedido. No exemplo, o Step1 passo tem a sua AllowReturn propriedade definida como false. Depois de o utilizador sair do Step1 passo, não aparece o botão Anterior nesse Step2 passo.

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

Observações

A AllowReturn propriedade pode ser usada para impor navegação linear num Wizard controlo. Se cada passo tiver a sua AllowReturn propriedade definida para false, o utilizador não poderá regressar a um passo depois de este ter sido acedido. Um cenário em que pode usar esta funcionalidade é impedir que um utilizador volte a uma etapa depois de esta ter sido concluída, porque está a persistir os dados numa base de dados à medida que cada etapa é concluída. Se guardar os dados após cada etapa e permitir que o utilizador volte a um passo e altere a informação depois de este ter sido guardado, os dados guardados podem corromper-se. Ao definir a AllowReturn propriedade para false, uma vez que o utilizador tenha saído de um passo, não poderá voltar a ela e alterar quaisquer valores.

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

Scenario	Comportamento
Linear: O passo 1 está AllowReturn definido como `false` e a ação do utilizador vai para o passo 2.	O Passo 2 não mostra o botão Anterior .
Não Linear: O Passo 1 está AllowReturn definido como `false` e a ação do utilizador vai para o passo 3.	O Passo 3 não mostra o botão Anterior .
Botões da Barra Lateral: O Passo 2 está AllowReturn definido para `false` , DisplaySideBar está definido para `true`, e o utilizador clica no botão da Barra Lateral.	Nenhum botão é automaticamente desativado na barra lateral quando AllowReturn está definido para `false`. Se um utilizador clicar no botão, a ação é ignorada.
Linear e Não Linear com Modelo Personalizado: O passo tem um modelo de navegação personalizado.	Não ocorre ocultação ou exibição automática se AllowReturn estiver definido para `false` usar um modelo para navegação. O botão Anterior deve ser opcional no modelo.
Usando o Visual Studio Designer e ActiveStepIndex : O controlo tem 5 passos, estás a trabalhar no passo 4 e executas a página.	Quando o passo 4 é o ActiveStepIndex, então o botão Anterior é renderizado. O botão Anterior só fica oculto para StepType definir para Step quando o passo anterior no histórico está AllowReturn definido para `false`. Como o passo 4 é renderizado primeiro e não há passos no histórico, o botão Anterior não está oculto.
Iniciar Passo e Navegação Não Linear: Um utilizador visita o passo 3 e o passo 4 e depois o passo 1, que tem StepType definido para Start.	O assistente não adiciona um botão Anterior quando está StepType definido para Start , independentemente de como o utilizador avança para essa etapa.
Mesmo Passo No Histórico: Um utilizador visita o passo 3 onde StepType está definido para Step e o utilizador não compromete as suas ações. Depois, clicam no botão anterior no passo 3.	O controlo do assistente verifica se a etapa Anterior no histórico é a "mesma" etapa em que o utilizador se encontra. Se o passo for o mesmo, o controlo do assistente recua no histórico para determinar o passo "diferente" anterior e baseia a visualização do botão Anterior e do destino no "passo diferente" do histórico.

Note

Quando a AllowReturn propriedade está definida para false, mas a DisplaySideBar propriedade do controlo pai de WizardStepBase está definida para true, clicar num botão na área da barra lateral não tem efeito. A área da barra lateral é geralmente apresentada para fornecer navegação não linear, por isso, se não estiver a usar a funcionalidade da navegação não linear, pode querer definir a DisplaySideBar propriedade para false.

Esta propriedade não pode ser definida por temas ou temas de folhas de estilo. Para mais informações, consulte ThemeableAttribute e ASP.NET Temas e Skins.

Aplica-se a

Ver também

Comentários

Esta página foi útil?