다음을 통해 공유

WizardStepBase.ID 속성

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls
어셈블리:
System.Web.dll

서버 컨트롤에 할당된 프로그래밍 ID를 가져오거나 설정합니다.

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

속성 값

String

컨트롤에 할당된 프로그래밍 ID입니다.

예외

ArgumentException

디자인 타임에 속성이 잘못된 식별자 문자열로 설정된 경우

또는

디자인 타임에 속성이 포함하는 Wizard 컨트롤과 동일한 식별자로 설정된 경우

또는

디자인 타임에 속성이 포함하는 Wizard 컨트롤에 있는 다른 단계와 동일한 식별자로 설정된 경우

예제

다음 코드 예제에서는 세 가지 마법사 단계에 대 한 정의 Wizard Web Forms 페이지에 있는 컨트롤입니다. 코드 페이지에서 마법사 단계 인스턴스는 해당 ID 값으로 명명 된 및로 코드를 참조할 수 있습니다 WizardStep1, WizardStep2, 및 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>

설명

사용 된 ID 속성을 식별 하 고 특정 마법사 단계 컨트롤을 Web Forms 페이지를 참조 합니다. ID 값 페이지에서 컨트롤 인스턴스의 이름이 됩니다. 이렇게 하면 해당 페이지에 대 한 코드의 특정 단계에 쉽게 액세스할 수 있습니다. 예를 들어, 설정 하는 경우는 ID 의 속성을 WizardStepBase 제어 "1 단계"에 마법사 단계는 해당 페이지에 대 한 코드의 자식 컨트롤을 참조할 수 있습니다 Step1.Controls합니다.

WizardStepBase 제어 되도록의 각 단계는 Wizard 단계를 추가 하거나 디자인 타임에 수정할 때 컨트롤에 유효한 고유 식별자입니다. 설정한 경우에 예를 들어, 합니다 ID 식별자에 포함 된 다른 단계에 대 한 디자인 타임에는 단계에 대 한 일치를 Wizard 제어 하며 일치할 수 없습니다.를 ID 포함 하 Wizard 컨트롤입니다.

적용 대상

추가 정보