WizardStepBase.AllowReturn Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit une valeur indiquant si l'utilisateur est autorisé à revenir à l'étape actuelle à partir d'une étape suivante dans une collection 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

Valeur de propriété

Boolean

true si l'utilisateur est autorisé à revenir à l'étape actuelle ; sinon, false. La valeur par défaut est true.

Attributs
ThemeableAttribute

Exemples

L’exemple suivant illustre l’utilisation de la AllowReturn propriété pour empêcher l’utilisateur de revenir à une étape du Wizard contrôle une fois qu’il a été accédé. Dans l’exemple, la propriété de l’étape Step1 est AllowReturn définie sur false. Une fois que l’utilisateur a quitté l’étape Step1 , aucun bouton Précédent n’apparaît sur l’étape Step2 .

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

Remarques

La AllowReturn propriété peut être utilisée pour appliquer la navigation linéaire dans un Wizard contrôle. Si chaque étape a sa AllowReturn propriété définie sur false, l’utilisateur ne pourra pas revenir à une étape une fois qu’elle a été consultée. L’un des scénarios où vous pouvez utiliser cette fonctionnalité consiste à interdire à un utilisateur de revenir à une étape une fois celle-ci terminée, car vous conservez les données dans une base de données à mesure que chaque étape est terminée. Si vous enregistrez les données après chaque étape et autorisez l’utilisateur à revenir à une étape et à modifier les informations une fois qu’elles ont été enregistrées, les données enregistrées peuvent être endommagées. En définissant la AllowReturn propriété sur false, une fois que l’utilisateur a quitté une étape, il ne peut pas y revenir et modifier des valeurs.

La AllowReturn propriété détermine comment et quand le bouton Précédent n’est pas affiché. Le tableau suivant décrit le comportement de rendu du bouton Précédent .

Scénario Comportement
Linéaire : Step1 a AllowReturn défini sur false et l’action de l’utilisateur passe à l’étape 2. L’étape 2 n’affiche pas le bouton Précédent .
Non linéaire : Step1 a AllowReturn défini sur false et l’action de l’utilisateur passe à l’étape 3. L’étape 3 n’affiche pas le bouton Précédent .
Boutons de barre latérale : l’étape 2 a AllowReturn la valeur false , DisplaySideBar est définie truesur , et un utilisateur clique sur le bouton Barre latérale. Aucun bouton n’est automatiquement désactivé dans la barre latérale lorsque AllowReturn est défini sur false. Si un utilisateur clique sur le bouton, l’action est ignorée.
Linéaire & non linéaire avec modèle personnalisé : l’étape a un modèle de navigation personnalisé. Aucun masquage ou affichage automatique ne se produit si AllowReturn est défini sur false lorsque vous utilisez un modèle pour la navigation. Le bouton Précédent doit être facultatif sur le modèle.
À l’aide de Visual Studio Designer et ActiveStepIndex : Le contrôle comporte 5 étapes, vous travaillez sur l’étape 4 et vous exécutez la page. Lorsque l’étape 4 est , ActiveStepIndexle bouton Précédent est affiché. Le bouton Précédent est masqué uniquement pour StepType défini sur Step lorsque l’étape précédente de l’historique a AllowReturn la valeur false. Étant donné que l’étape 4 est rendue en premier et qu’il n’y a aucune étape dans l’historique, le bouton Précédent n’est pas masqué.
Étape de démarrage et navigation non linéaire : un utilisateur visite les étapes 3 et 4, puis l’étape 1 qui a StepType défini sur Start. L’Assistant n’ajoute pas de bouton Précédent lorsque est StepType défini sur Start , quelle que soit la façon dont l’utilisateur accède à cette étape.
Même étape dans l’historique : un utilisateur visite l’étape 3 où StepType est défini sur Step et où l’utilisateur ne valide pas ses actions. Ils cliquent ensuite sur le bouton précédent à l’étape 3. Le contrôle de l’Assistant vérifie si l’étape Précédente de l’historique est la même que celle de l’utilisateur. Si l’étape est la même, le contrôle de l’Assistant examine l’historique pour déterminer l’étape « différente » précédente et base l’affichage du bouton Précédent et de la destination en fonction de la « étape différente » dans l’historique.

Notes

Lorsque la propriété a la AllowReturn valeur , mais que la DisplaySideBar propriété du contrôle parent de a la valeur true, le fait de WizardStepBase cliquer sur un bouton dans la zone de barre latérale n’a aucun falseeffet. La zone de barre latérale est généralement affichée pour fournir une navigation non linéaire. Par conséquent, si vous n’utilisez pas la fonctionnalité de navigation non linéaire, vous pouvez définir la DisplaySideBar propriété sur false.

Cette propriété ne peut pas être définie par les thèmes ou les thèmes de feuille de style. Pour plus d’informations, consultez ThemeableAttribute et ASP.NET Thèmes et apparences.

S’applique à

Voir aussi