WizardStepBase.ID 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 pengidentifikasi terprogram yang ditetapkan ke kontrol server.

public:
 virtual property System::String ^ ID { System::String ^ get(); void set(System::String ^ value); };

public override string ID { get; set; }

member this.ID : string with get, set

Public Overrides Property ID As String

Nilai Properti

String

Pengidentifikasi terprogram yang ditetapkan ke kontrol.

Pengecualian

ArgumentException

Properti diatur ke string pengidentifikasi yang tidak valid pada waktu desain.

-atau-

Properti diatur ke pengidentifikasi yang sama dengan kontrol yang berisi Wizard pada waktu desain.

-atau-

Properti diatur ke pengidentifikasi yang sama dengan langkah lain dalam kontrol yang berisi Wizard pada waktu desain.

Contoh

Contoh kode berikut menentukan tiga langkah panduan untuk Wizard kontrol di halaman Formulir Web. Dalam kode untuk halaman, instans langkah wizard dinamai berdasarkan nilai ID mereka, dan dapat dirujuk dalam kode sebagai WizardStep1, , WizardStep2dan WizardStep3.

<%@ 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 if the 
    // CheckBox1 CheckBox is checked.  If it is then skip 
    // to the Step3 step.
    if (Wizard1.ActiveStep == 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="Check this checkbox 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 if the 
    ' CheckBox1 CheckBox is checked.  If it is then skip 
    ' to the Step3 step.
    If Wizard1.ActiveStep.Equals(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="Check this checkbox 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

ID Gunakan properti untuk mengidentifikasi dan mereferensikan kontrol langkah wizard tertentu di halaman Formulir Web. Nilai ID menjadi nama instans kontrol di halaman; ini memungkinkan Anda untuk dengan mudah mengakses langkah tertentu dalam kode untuk halaman tersebut. Misalnya, jika Anda mengatur ID properti WizardStepBase kontrol ke "Step1", Anda dapat mereferensikan kontrol anak dari langkah wizard dalam kode untuk halaman tersebut sebagai Step1.Controls.

Kontrol WizardStepBase memastikan bahwa setiap langkah dalam Wizard kontrol memiliki pengidentifikasi unik yang valid ketika langkah-langkah ditambahkan atau dimodifikasi pada waktu desain. Misalnya, ketika Anda mengatur ID untuk langkah pada waktu desain, itu tidak dapat mencocokkan pengidentifikasi untuk langkah lain yang terkandung dalam Wizard kontrol, dan tidak dapat cocok ID dengan untuk kontrol yang berisi Wizard .

Berlaku untuk

Bagikan melalui