Aracılığıyla paylaş

WizardStepBase.ID Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Sunucu denetimine atanan programlı tanımlayıcıyı alır veya ayarlar.

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

Özellik Değeri

String

Denetime atanan programlı tanımlayıcı.

Özel durumlar

ArgumentException

özelliği, tasarım zamanında geçersiz bir tanımlayıcı dizesine ayarlandı.

-veya-

özelliği, tasarım zamanında içeren Wizard denetimle aynı tanımlayıcıya ayarlanmıştır.

-veya-

özelliği, tasarım zamanında denetim içeren Wizard başka bir adımla aynı tanımlayıcıya ayarlanmıştır.

Örnekler

Aşağıdaki kod örneği, Web Forms sayfasındaki bir Wizard denetim için üç sihirbaz adımını tanımlar. Sayfanın kodunda sihirbaz adımı örnekleri kimlik değerleriyle adlandırılır ve kodda , WizardStep2ve WizardStep3olarak WizardStep1başvurulabilir.

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

Açıklamalar

ID Web Forms sayfasındaki belirli bir sihirbaz adımı denetimini tanımlamak ve bunlara başvurmak için özelliğini kullanın. Değer, ID sayfadaki denetim örneğinin adı olur; bu, söz konusu sayfa için kodda belirli bir adıma kolayca erişmenizi sağlar. Örneğin, denetimin IDWizardStepBase özelliğini "Adım1" olarak ayarlarsanız, bu sayfanın kodda sihirbaz adımının alt denetimlerine olarak Step1.Controlsbaşvurabilirsiniz.

Denetim, WizardStepBase tasarım zamanında adımlar eklendiğinde veya değiştirildiğinde denetimdeki Wizard her adımın geçerli bir benzersiz tanımlayıcıya sahip olmasını sağlar. Örneğin, tasarım zamanında bir adım için değerini ayarladığınızdaID, denetimde yer alan başka bir adımın Wizard tanımlayıcısını eşleştiremez ve içeren Wizard denetimin tanımlayıcısını ID eşleştiremez.

Şunlara uygulanır

Ayrıca bkz.