WizardStepBase.ID Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví programový identifikátor přiřazený ovládacímu prvku serveru.
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
Hodnota vlastnosti
Programový identifikátor přiřazený ovládacímu prvku.
Výjimky
Vlastnost byla nastavena na neplatný řetězec identifikátoru v době návrhu.
-nebo- Vlastnost byla nastavena na stejný identifikátor jako ovládací prvek obsahující Wizard v době návrhu.
-nebo- Vlastnost byla nastavena na stejný identifikátor jako další krok obsahující ovládací prvek v době návrhu Wizard .
Příklady
Následující příklad kódu definuje tři kroky průvodce pro Wizard ovládací prvek na Web Forms stránce. V kódu stránky jsou instance kroku průvodce pojmenované podle jejich HODNOT ID a mohou být odkazovány v kódu jako WizardStep1
, WizardStep2
a 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>
Poznámky
ID Vlastnost slouží k identifikaci a odkaz na konkrétní ovládací prvek kroku průvodce na stránce Web Forms. Hodnota ID se stane názvem instance ovládacího prvku na stránce. To vám umožní snadno získat přístup k určitému kroku v kódu této stránky. Pokud například nastavíte ID vlastnost WizardStepBase ovládacího prvku na Krok1, můžete odkazovat na podřízené ovládací prvky kroku průvodce v kódu této stránky jako Step1.Controls
.
Ovládací WizardStepBase prvek zajistí, že každý krok v ovládacím Wizard prvku má platný jedinečný identifikátor při přidání nebo změně kroků v době návrhu. Pokud například nastavíte ID krok v době návrhu, nemůže odpovídat identifikátoru pro jiný krok obsažený v ovládacím Wizard prvku a nemůže se shodovat ID s ovládacím prvek obsahujícím Wizard .