WizardStepBase.AllowReturn Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ottiene o imposta un valore che indica se l'utente può tornare al passaggio corrente da un passaggio successivo di un insieme 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

Valore della proprietà

Boolean

true se l'utente può tornare al passaggio corrente, altrimenti false. Il valore predefinito è true.

Attributi
ThemeableAttribute

Esempio

Nell'esempio seguente viene illustrato l'utilizzo della AllowReturn proprietà per impedire all'utente di tornare a un passaggio del controllo dopo l'accesso Wizard . Nell'esempio il Step1 passaggio ha la relativa AllowReturn proprietà impostata su false. Dopo che l'utente lascia il Step1 passaggio, non viene visualizzato alcun pulsante Indietro nel Step2 passaggio.

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

Commenti

La AllowReturn proprietà può essere utilizzata per applicare lo spostamento lineare in un Wizard controllo . Se ogni passaggio ha la proprietà AllowReturn impostata su false, l'utente non sarà in grado di tornare a un passaggio dopo l'accesso. Uno scenario in cui è possibile usare questa funzionalità consiste nel impedire a un utente di tornare a un passaggio dopo che è stato completato perché i dati vengono salvati in modo permanente in un database al termine di ogni passaggio. Se si salvano i dati dopo ogni passaggio e si consente all'utente di tornare a un passaggio e di modificare le informazioni dopo il salvataggio, i dati salvati potrebbero diventare danneggiati. Impostando la AllowReturn proprietà su false, una volta che l'utente ha lasciato un passaggio, non sarà possibile tornare ad esso e modificare i valori.

La AllowReturn proprietà determina come e quando non viene eseguito il rendering del pulsante Indietro . Nella tabella seguente viene descritto il comportamento di rendering del pulsante Indietro .

Scenario Comportamento
Lineare: Il passaggio 1 è AllowReturn impostato su false e l'azione dell'utente passa al passaggio 2. Il passaggio 2 non visualizza il pulsante Indietro .
Non lineare: Il passaggio 1 è AllowReturn impostato su false e l'azione dell'utente passa al passaggio 3. Il passaggio 3 non visualizza il pulsante Indietro .
Pulsanti della barra laterale: il passaggio 2 ha AllowReturn impostato su , DisplaySideBar è impostato false su truee un utente fa clic sul pulsante SideBar. Nessun pulsante viene disabilitato automaticamente sulla barra laterale quando AllowReturn è impostato su false. Se un utente fa clic sul pulsante, l'azione viene ignorata.
Lineare & non lineare con modello personalizzato: il passaggio include un modello di spostamento personalizzato. Non viene visualizzato o nascosto automaticamente se AllowReturn è impostato su false quando si usa un modello per la navigazione. Il pulsante Indietro deve essere facoltativo nel modello.
Usando visual Studio Designer e ActiveStepIndex : il controllo include 5 passaggi, si sta lavorando al passaggio 4 ed è possibile eseguire la pagina. Quando il ActiveStepIndexpassaggio 4 è , viene eseguito il rendering del pulsante Indietro . Il pulsante Indietro è nascosto solo per StepType impostato su Step quando il passaggio precedente nella cronologia è AllowReturn impostato su false. Poiché il rendering del passaggio 4 viene eseguito per primo e non sono presenti passaggi nella cronologia, il pulsante Indietro non è nascosto.
Avvia passaggio e navigazione non lineare: un utente visita il passaggio 3 e il passaggio 4 e quindi il passaggio 1 impostato StepType su Start. La procedura guidata non aggiunge un pulsante Indietro quando è StepType impostato su Start indipendentemente dal modo in cui l'utente passa a tale passaggio.
Stesso passaggio nella cronologia: un utente visita il passaggio 3 in cui StepType è impostato su Step e l'utente non esegue il commit delle azioni. Fanno quindi clic sul pulsante precedente al passaggio 3. Il controllo della procedura guidata verifica se il passaggio Precedente nella cronologia è lo stesso che l'utente è attualmente in esecuzione. Se il passaggio è lo stesso, il controllo della procedura guidata esamina nuovamente la cronologia per determinare il passaggio "diverso" precedente e basa la visualizzazione del pulsante Indietro e della destinazione in base al "passaggio diverso" nella cronologia.

Nota

Quando la AllowReturn proprietà è impostata su false, ma la DisplaySideBar proprietà del controllo padre di WizardStepBase è impostata truesu , facendo clic su un pulsante nell'area della barra laterale non ha alcun effetto. L'area della barra laterale viene in genere visualizzata per fornire lo spostamento non lineare, pertanto se non si utilizza la funzionalità di navigazione non lineare, è possibile impostare la DisplaySideBar proprietà su false.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e interfacce.

Si applica a

Vedi anche