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 a livello di codice 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à
L'identificatore a livello di codice assegnato al controllo.
Eccezioni
La proprietà è stata impostata su una stringa di identificazione non valida in fase di progettazione.
-oppure-
La proprietà è stata impostata sullo stesso identificatore del controllo Wizard contenitore in fase di progettazione.
-oppure-
La proprietà è stata impostata sullo stesso identificatore di un altro passaggio nel controllo Wizard contenitore in fase di progettazione.
Esempio
L'esempio di codice seguente definisce tre passaggi della procedura guidata per un Wizard controllo in una pagina Web Forms. Nel codice della pagina, le istanze dei passaggi della procedura guidata vengono denominate dai valori ID e possono essere riferimenti al 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
Usare la ID proprietà per identificare e fare riferimento a un determinato controllo passaggio della procedura guidata in una pagina Web Forms. Il ID valore diventa il nome dell'istanza del controllo nella pagina. Ciò consente di accedere facilmente a un determinato passaggio nel codice per tale pagina. Ad esempio, se si imposta la ID proprietà di un WizardStepBase controllo su "Passaggio1", è 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 in un Wizard controllo disponga di un identificatore univoco valido quando vengono aggiunti o modificati in fase di progettazione. Ad esempio, quando si imposta l'oggetto ID per un passaggio in fase di progettazione, non può corrispondere all'identificatore per un altro passaggio contenuto nel Wizard controllo e non può corrispondere all'oggetto ID per il controllo contenente Wizard .
