WizardStepBase.AllowReturn Propriété

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 d’une WizardStepCollection collection.

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, l’étape Step1 a sa AllowReturn propriété définie sur false. Une fois que l’utilisateur a quitté l’étape Step1 , aucun bouton Précédent n’apparaît à 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 falsesur , l’utilisateur ne pourra pas revenir à une étape une fois qu’il a été accédé. Un scénario dans lequel vous pouvez utiliser cette fonctionnalité consiste à interdire à un utilisateur de revenir à une étape une fois qu’il a été terminé, 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 autorisez l’utilisateur à revenir à une étape et à modifier les informations après son enregistrement, les données enregistrées peuvent être endommagées. En définissant la AllowReturn propriété falsesur , une fois que l’utilisateur a laissé une étape, il ne pourra pas y revenir et modifier les valeurs.

La AllowReturn propriété détermine comment et quand le bouton Précédent n’est pas rendu. 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 `false` sur et l’action de l’utilisateur passe à l’étape 2.	L’étape 2 n’affiche pas le bouton Précédent .
Non linéaire : l’étape 1 a AllowReturn défini `false` sur et l’action de l’utilisateur passe à l’étape 3.	L’étape 3 n’affiche pas le bouton Précédent .
Boutons SideBar : l’étape 2 a AllowReturn la `false` valeur , DisplaySideBar est définie `true`sur , et un utilisateur clique sur le bouton SideBar.	Aucun bouton n’est automatiquement désactivé sur la barre latérale lorsqu’il AllowReturn est défini `false`sur . Si un utilisateur clique sur le bouton, l’action est ignorée.
Linéaire et non linéaire avec modèle personnalisé : l’étape a un modèle de navigation personnalisé.	Aucun masquage automatique ou affichage ne se produit s’il AllowReturn est défini `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 la ActiveStepIndex, le bouton Précédent est affiché. Le bouton Précédent n’est masqué que lorsque StepType Step 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 pas d’étapes dans l’historique, le bouton Précédent n’est pas masqué.
Démarrer l’étape et la navigation non linéaire : un utilisateur visite l’étape 3 et l’étape 4, puis l’étape 1 définie StepType sur Start.	L’Assistant n’ajoute pas de bouton Précédent lorsque celui-ci StepType est défini Start sur la façon dont l’utilisateur accède à cette étape.
Même étape dans l’historique : un utilisateur visite l’étape 3 sur StepType laquelle est définie Step et 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 » étape que celle sur laquelle l’utilisateur est actuellement activé. Si l’étape est identique, le contrôle 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.

Note

Lorsque la AllowReturn propriété est définie falsesur , mais que la DisplaySideBar propriété du contrôle parent est WizardStepBase définie truesur , le fait de cliquer sur un bouton dans la zone de 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 la fonctionnalité de navigation non linéaire, vous pouvez définir la DisplaySideBar propriété falsesur .

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

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?