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'uso della AllowReturn proprietà per impedire all'utente di tornare a un passaggio del Wizard controllo dopo l'accesso. Nell'esempio il Step1 passaggio ha la relativa AllowReturn proprietà impostata su false. Dopo che l'utente lascia il passaggio, non viene visualizzato alcun Step1 pulsante Precedente 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 usata 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 mantenuti in un database man mano che ogni passaggio viene completato. Se si salvano i dati dopo ogni passaggio e si consente all'utente di tornare a un passaggio e modificare le informazioni dopo il salvataggio, i dati salvati potrebbero essere danneggiati. Impostando la proprietà su false, una volta che l'utente AllowReturn ha lasciato un passaggio, non sarà possibile tornare a esso e modificare i valori.

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

Scenario Comportamento
Lineare: Passaggio1 è AllowReturn impostato su false e l'azione utente passa al passaggio 2. Il passaggio 2 non visualizza il pulsante Precedente .
Non lineare: Passaggio1 è AllowReturn impostato su false e l'azione utente passa al passaggio 3. Il passaggio 3 non visualizza il pulsante Precedente .
Pulsanti SideBar: il passaggio 2 è AllowReturn impostato su false , DisplaySideBar è impostato 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 ha un modello di spostamento personalizzato. Non viene visualizzato o nascosto automatico se è impostato su AllowReturnfalse quando si usa un modello per la navigazione. Il pulsante Precedente deve essere facoltativo nel modello.
Uso di Visual Studio Designer e ActiveStepIndex : il controllo ha 5 passaggi, si sta lavorando al passaggio 4 e si esegue la pagina. Quando il passaggio 4 è , ActiveStepIndexviene eseguito il rendering del pulsante Precedente . Il pulsante Precedente è nascosto solo per StepType impostato su Step quando il passaggio precedente della cronologia è AllowReturn impostato su false. Poiché il passaggio 4 viene eseguito il rendering per primo e non sono presenti passaggi nella cronologia, il pulsante Precedente non è nascosto.
Avvio passaggio e spostamento non lineare: un utente visita il passaggio 3 e il passaggio 4 e quindi il passaggio 1 StepType impostato su Start. La procedura guidata non aggiunge un pulsante Precedente quando l'oggetto 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. Quindi fare clic sul pulsante precedente nel passaggio 3. Il controllo procedura guidata verifica se il passaggio Precedente nella cronologia è lo stesso passaggio in cui l'utente è attualmente attivo. Se il passaggio è lo stesso, il controllo della procedura guidata torna nella cronologia per determinare il passaggio "diverso" precedente e basa la visualizzazione del pulsante Precedente 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 su true, 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, quindi se non si usa la funzionalità di spostamento nonlineare, è 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 skin.

Si applica a

Vedi anche