Exporter (0) Imprimer
Développer tout
Développer Réduire
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Wizard.ActiveStepIndex, propriété

Mise à jour : novembre 2007

Obtient ou définit l'index de l'objet WizardStepBase actuel.

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)

[ThemeableAttribute(false)]
public virtual int ActiveStepIndex { get; set; }
/** @property */
/** @attribute ThemeableAttribute(false) */
public int get_ActiveStepIndex()
/** @property */
/** @attribute ThemeableAttribute(false) */
public  void set_ActiveStepIndex(int value)

public function get ActiveStepIndex () : int
public function set ActiveStepIndex (value : int)
<asp:Wizard ActiveStepIndex="Int32" />

Valeur de propriété

Type : System.Int32

Index de l'objet WizardStepBase qui est actuellement affiché dans le contrôle Wizard.

ExceptionCondition
ArgumentOutOfRangeException

La valeur sélectionnée est plus haute que le nombre d'étapes d'Assistant défini dans la collection WizardSteps.

La propriété ActiveStepIndex fournit l'index de base zéro de l'objet WizardStepBase qui est actuellement affiché dans le contrôle Wizard. Vous pouvez définir par programme la propriété ActiveStepIndex afin de contrôler l'étape qui est affichée à l'attention de l'utilisateur au moment de l'exécution.

Remarque :

Si vous utilisez Microsoft Visual Studio 2005, notez que ActiveStepIndex est rendu persistant en mode Source. Si vous modifiez la propriété WizardSteps en mode Design en cliquant sur les boutons de la barre latérale, et si vous exécutez la page, la première étape du contrôle Wizard peut ne pas être affichée, car il est possible que ActiveStepIndex pointe vers une autre étape.

Si vous affectez -1 à la valeur de ActiveStepIndex pour prendre en charge un Assistant sans étapes par défaut, le comportement suivant se produit :

  • Si vous affectez -1 à ActiveStepIndex de façon déclarative ou si vous lui affectez -1 comme valeur par défaut, le contrôle essaiera toujours de restituer la première étape dans l'Assistant.

  • Si vous affectez -1 à ActiveStepIndex par programme, le contrôle ne restituera pas.

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 Vue d'ensemble des thèmes et des apparences ASP.NET.

L'exemple de code suivant montre comment utiliser le contrôle ActiveStepIndex pour définir la propriété ActiveStep du contrôle Wizard. Si la propriété CheckBox1.Checked a la valeur true, la propriété ActiveStep a la valeur Wizard1.Step3 ; sinon, la propriété ActiveStep a la valeur Wizard1.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">

  void OnActiveStepChanged(object sender, EventArgs e)
  {
    // If the ActiveStep is changing to Step2, check to see whether the 
    // CheckBox1 CheckBox is selected.  If it is, skip to the Step2 step.
    if (Wizard1.ActiveStepIndex == Wizard1.WizardSteps.IndexOf(this.WizardStep2))
    {
      if (this.CheckBox1.Checked)
      {
        Wizard1.ActiveStepIndex = Wizard1.WizardSteps.IndexOf(this.WizardStep3);
      }
    }
  }

</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"
          OnActiveStepChanged="OnActiveStepChanged">
          <WizardSteps>
            <asp:WizardStep id="WizardStep1" 
              title="Step 1" 
              runat="server">
              <asp:CheckBox id="CheckBox1" 
                runat="Server" 
                text="Select this check box to skip Step 2." />
                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" 
              runat="server" 
              title="Step 3">
              You are currently on Step 3.
            </asp:WizardStep>
          </WizardSteps>
          <HeaderTemplate>
            <b>ActiveStepIndex Example</b>
          </HeaderTemplate>
        </asp:Wizard>
      </form>
  </body>
</html>


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft. Tous droits réservés.