WizardStepBase.ID Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta l'identificatore programmatico assegnato al controllo 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, setPublic Overrides Property ID As StringValore della proprietà
Identificatore programmatico assegnato al controllo.
Eccezioni
La proprietà è stata impostata su una stringa di identificatore non valida in fase di progettazione.
oppure
La proprietà è stata impostata sullo stesso identificatore del controllo contenitore Wizard in fase di progettazione.
oppure
La proprietà è stata impostata sullo stesso identificatore di un altro passaggio del controllo contenitore Wizard in fase di progettazione.
Esempio
Nell'esempio di codice seguente vengono definiti tre passaggi della procedura guidata per un Wizard controllo in una pagina Web Form. Nel codice per la pagina, le istanze del passaggio della procedura guidata vengono denominate dai relativi valori ID e possono essere referenziate nel codice come WizardStep1, WizardStep2e 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>
Commenti
Utilizzare la ID proprietà per identificare e fare riferimento a un particolare controllo passaggio della procedura guidata in una pagina Web Form. Il ID valore diventa il nome dell'istanza del controllo nella pagina. Ciò consente di accedere facilmente a un particolare passaggio nel codice per tale pagina. Ad esempio, se si imposta la ID proprietà di un WizardStepBase controllo su "Step1", è possibile fare riferimento ai controlli figlio del passaggio della procedura guidata nel codice per tale pagina come Step1.Controls.
Il WizardStepBase controllo garantisce che ogni passaggio di un Wizard controllo abbia un identificatore univoco valido quando vengono aggiunti o modificati passaggi in fase di progettazione. Ad esempio, quando si imposta per ID un passaggio in fase di progettazione, non può corrispondere all'identificatore di un altro passaggio contenuto nel Wizard controllo e non può corrispondere a ID per il controllo contenitore Wizard .
