WizardStepBase.AllowReturn Propriété

Référence

Définition

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

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 après y avoir 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é accédé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 que vous permettez à l’utilisateur de revenir à une étape et de 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 laissé une étape, il ne peut pas y revenir et modifier les 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 : l’étape 1 a AllowReturn défini sur `false` et l’action utilisateur passe à l’étape 2.	L’étape 2 n’affiche pas le bouton Précédent .
Non linéaire : l’étape 1 a AllowReturn la valeur `false` et l’action 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 a la valeur `true`, et un utilisateur clique sur le bouton SideBar.	Aucun bouton n’est automatiquement désactivé dans la barre latérale quand 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é.	Aucune 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 du Concepteur Visual Studio et ActiveStepIndex : Le contrôle comporte 5 étapes, vous travaillez à 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 la valeur 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 Step sur 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 identique, le contrôle de l’Assistant revient dans 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 l'« étape différente » dans l’historique.

Notes

Lorsque la propriété a la AllowReturn valeur false, 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 la barre latérale n’a aucun effet. 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 les fonctionnalités de la 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 skins.

S’applique à

Partager via