WizardStepBase.AllowReturn Propiedad

  • Referencia

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 en una colección 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 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 cómo usar 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 . Una vez que el usuario deja 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 una vez 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 y cambiar los valores.

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: El paso 1 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 en false , DisplaySideBar se establece trueen y un usuario hace clic en el botón Barra lateral. No hay botones deshabilitados automáticamente en la barra lateral cuando AllowReturn se establece falseen . Si un usuario hace clic en el botón, se omite la acción.
Lineal & no lineal con plantilla personalizada: el paso tiene una plantilla de navegación personalizada. No se oculta o se muestra automáticamente 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 Designer de Visual Studio y ActiveStepIndex : el control tiene 5 pasos, está trabajando en el paso 4 y ejecuta la página. Cuando el ActiveStepIndexpaso 4 es , se representa el botón Anterior . El botón Anterior solo está oculto para StepType establecer en Step cuando el paso anterior del historial se ha AllowReturn establecido falseen . Puesto que el paso 4 se representa primero y no hay ningún paso 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 en el paso 3. El control del asistente comprueba si el paso anterior del historial es el paso "mismo" en el que está actualmente el usuario. Si el paso es el mismo, el control del asistente vuelve a buscar en el historial para determinar el paso "diferente" anterior 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 en el á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 o temas de la hoja de estilos. Para obtener más información, vea ThemeableAttribute y ASP.NET Temas y máscaras.

Se aplica a

Consulte también