Wizard.ActiveStepIndex Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur indeks objek saat ini WizardStepBase .

public:
 virtual property int ActiveStepIndex { int get(); void set(int value); };

[System.Web.UI.Themeable(false)]
public virtual int ActiveStepIndex { get; set; }

[<System.Web.UI.Themeable(false)>]
member this.ActiveStepIndex : int with get, set

Public Overridable Property ActiveStepIndex As Integer

Nilai Properti

Int32

Indeks WizardStepBase yang saat ini ditampilkan dalam Wizard kontrol.

Atribut: ThemeableAttribute

Pengecualian

ArgumentOutOfRangeException

Nilai yang dipilih lebih tinggi dari jumlah langkah wizard yang ditentukan dalam WizardSteps koleksi.

Contoh

Contoh kode berikut menunjukkan cara menggunakan ActiveStepIndex properti untuk mengatur ActiveStep properti Wizard kontrol. Jika nilai CheckBox1.Checked adalah true, ActiveStep properti diatur ke Wizard1.Step3; jika tidak, ActiveStep properti diatur ke 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>

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

  Sub OnActiveStepChanged(ByVal sender As Object, ByVal e As EventArgs)
    ' If the ActiveStep is changing to Step2, check to see whether the 
    ' CheckBox1 CheckBox is selected.  If it is, skip to the Step3 step. 
    If (Wizard1.ActiveStepIndex = Wizard1.WizardSteps.IndexOf(Me.WizardStep2)) Then
      If (Me.CheckBox1.Checked) Then
        Wizard1.ActiveStepIndex = Wizard1.WizardSteps.IndexOf(Me.WizardStep3)
      End If
    End If
  End Sub
  
</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>

Keterangan

Properti ActiveStepIndex menyediakan indeks berbasis nol dari WizardStepBase objek yang saat ini ditampilkan dalam Wizard kontrol. Anda dapat mengatur ActiveStepIndex properti secara terprogram untuk mengontrol langkah mana yang ditampilkan kepada pengguna pada durasi.

Catatan

Jika Anda menggunakan Microsoft Visual Studio 2005, perhatikan bahwa ActiveStepIndex tetap ada dalam tampilan Sumber. Jika Anda mengubah WizardSteps properti dalam tampilan Desain dengan mengklik tombol bilah samping, lalu menjalankan halaman, langkah Wizard pertama kontrol mungkin tidak ditampilkan karena ActiveStepIndex mungkin menunjuk ke langkah yang berbeda.

Jika Anda mengatur nilai ActiveStepIndex ke -1 untuk mendukung wizard tanpa langkah secara default, perilaku berikut terjadi:

Jika Anda secara deklaratif mengatur ActiveStepIndex ke -1 atau mengaturnya ke -1 sebagai nilai default, kontrol akan selalu mencoba merender langkah pertama dalam wizard.
Jika Anda secara terprogram mengatur ActiveStepIndex ke -1, kontrol tidak akan dirender.

Properti ini tidak dapat diatur oleh tema atau tema lembar gaya. Untuk informasi selengkapnya, lihat ThemeableAttribute dan ASP.NET Tema dan Kulit.

Berlaku untuk

Bagikan melalui