Compartir por

WizardStepBase.AllowReturn Propiedad

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece un valor que indica si el usuario puede volver al paso actual desde un paso posterior de una WizardStepCollection colección.

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 propiedad

Boolean

true si el usuario puede volver al paso actual; de lo contrario, false. El valor predeterminado es true.

Atributos
ThemeableAttribute

Ejemplos

En el ejemplo siguiente se muestra el uso de la AllowReturn propiedad para impedir que el usuario vuelva a un paso del Wizard control después de que se haya accedido a ella. En el ejemplo, el Step1 paso tiene su AllowReturn propiedad establecida falseen . Después de que el usuario deje el Step1 paso, no aparece ningún botón Anterior en el Step2 paso.

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

Comentarios

La AllowReturn propiedad se puede usar para aplicar la navegación lineal en un Wizard control . Si cada paso tiene su AllowReturn propiedad establecida falseen , el usuario no podrá volver a un paso después de que se haya accedido. Un escenario en el que podría usar esta funcionalidad es no permitir que un usuario vuelva a un paso después de que se haya completado porque conserva los datos en una base de datos a medida que se completa cada paso. Si guarda los datos después de cada paso y permite al usuario volver a un paso y cambiar la información después de guardarlos, los datos guardados podrían dañarse. Al establecer la AllowReturn propiedad falseen , una vez que el usuario ha dejado un paso, no podrá volver a ella ni cambiar ningún valor.

La AllowReturn propiedad determina cómo y cuándo no se representa el botón Anterior . En la tabla siguiente se describe el comportamiento de representación del botón Anterior .

Escenario Comportamiento
Lineal: Step1 ha AllowReturn establecido en false y la acción del usuario va al paso 2. El paso 2 no muestra el botón Anterior .
No lineal: Step1 se ha AllowReturn establecido false en y la acción del usuario va al paso 3. El paso 3 no muestra el botón Anterior .
Botones de barra lateral: el paso 2 se ha AllowReturn establecido false en , DisplaySideBar se establece trueen y un usuario hace clic en el botón Barra lateral. No se deshabilitan automáticamente botones en la barra lateral cuando AllowReturn se establece en false. Si un usuario hace clic en el botón, se omite la acción.
Lineal y no lineal con plantilla personalizada: el paso tiene una plantilla de navegación personalizada. No se produce ninguna ocultación o visualización automática si AllowReturn se establece false en cuando se usa una plantilla para la navegación. El botón Anterior debe ser opcional en la plantilla.
Con el Diseñador de Visual Studio y ActiveStepIndex : el control tiene cinco pasos, está trabajando en el paso 4 y ejecuta la página. Cuando el paso 4 es ActiveStepIndex, se representa el botón Anterior . El botón Anterior solo está oculto para establecer en StepTypeStep cuando el paso anterior del historial se ha AllowReturn establecido falseen . Dado que el paso 4 se representa primero y no hay pasos en el historial, el botón Anterior no está oculto.
Iniciar paso y navegación no lineal: un usuario visita el paso 3 y el paso 4 y, a continuación, el paso 1 que se ha StepType establecido en Start. El asistente no agrega un botón Anterior cuando se establece Start en StepType independientemente de cómo navega el usuario a ese paso.
Mismo paso en el historial: un usuario visita el paso 3 donde StepType está establecido Step en y el usuario no confirma sus acciones. A continuación, hacen clic en el botón anterior del paso 3. El control del asistente comprueba si el paso Anterior del historial es el paso "mismo" en el que el usuario está actualmente activado. Si el paso es el mismo, el control del asistente vuelve a buscar en el historial para determinar el paso anterior "diferente" y basa la presentación del botón Anterior y el destino en función del "paso diferente" del historial.

Nota:

Cuando la AllowReturn propiedad se establece falseen , pero la DisplaySideBar propiedad del control primario de WizardStepBase está establecida trueen , al hacer clic en un botón del área de la barra lateral no tiene ningún efecto. Por lo general, el área de la barra lateral se muestra para proporcionar navegación no lineal, por lo que si no usa la funcionalidad de navegación no lineal, es posible que desee establecer la DisplaySideBar propiedad falseen .

Esta propiedad no se puede establecer mediante temas ni temas de hojas de estilos. Para obtener más información, vea ThemeableAttribute y ASP.NET Temas y máscaras.

Se aplica a

Consulte también