Condividi tramite

WizardStepBase.AllowReturn Proprietà

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 in una WizardStepCollection raccolta.

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; in caso contrario, 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, nel passaggio non viene visualizzato alcun Step2 pulsante Indietro.

<%@ 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 mantenuti 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 modificare le informazioni dopo il salvataggio, i dati salvati potrebbero essere danneggiati. Impostando la AllowReturn proprietà su false, una volta che l'utente ha lasciato un passaggio, non sarà in grado di restituirlo 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: Step1 è AllowReturn impostato su false e l'azione dell'utente passa al passaggio 3. Il passaggio 3 non visualizza il pulsante Indietro .
Pulsanti 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 e non lineare con modello personalizzato: il passaggio ha 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 La finestra di progettazione di Visual Studio e ActiveStepIndex : il controllo ha 5 passaggi, si sta lavorando al passaggio 4 ed è possibile eseguire la pagina. Quando il passaggio 4 è , ActiveStepIndexviene 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 Step su 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 passaggio in cui l'utente è attualmente attivo. Se il passaggio è lo stesso, il controllo procedura guidata esamina 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.

Annotazioni

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 non lineare, è possibile impostare la DisplaySideBar proprietà su false.

Questa proprietà non può essere impostata in base a temi o temi del foglio di stile. Per altre informazioni, vedere ThemeableAttribute e ASP.NET Temi e interfacce.

Si applica a

Vedi anche