WizardStepCollection.Insert(Int32, WizardStepBase) Método

  • Referência

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Insere o objeto derivado de WizardStepBase especificado na coleção no local do índice especificado.

public:
 void Insert(int index, System::Web::UI::WebControls::WizardStepBase ^ wizardStep);
public void Insert (int index, System.Web.UI.WebControls.WizardStepBase wizardStep);
member this.Insert : int * System.Web.UI.WebControls.WizardStepBase -> unit
Public Sub Insert (index As Integer, wizardStep As WizardStepBase)

Parâmetros

index
Int32

O local do índice no qual o objeto derivado de WizardStepBase deve ser inserido.

wizardStep
WizardStepBase

O objeto derivado de WizardStepBase a ser inserido na coleção WizardStepCollection.

Exemplos

O exemplo de código a WizardSteps seguir demonstra programaticamente a criação de um Wizard controle e o uso do Insert método para adicionar WizardStepBaseobjetos derivados à coleção. Observe que, no exemplo, a WizardSteps propriedade do Wizard controle é uma instância da WizardStepCollection classe.

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

  // Programmatically create a Wizard control and dynamically
  // add WizardStep objects to it.    
  
  void Page_Load(object sender, EventArgs e) 
  {
    Wizard WizardControl = new Wizard();
      
    // Create some steps for the wizard and insert them
    // into the WizardStepCollection collection.
    for (int i = 0; i <= 5; i++)
    {
      WizardStepBase newStep = new WizardStep();
      newStep.ID = "Step" + (i + 1).ToString();
      WizardControl.WizardSteps.Insert(0, newStep);
    }

    WizardControl.ActiveStepIndex = 0;
    WizardControl.DisplaySideBar = true;
    
    // Display the wizard on the page.
    PlaceHolder1.Controls.Add(WizardControl);
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>WizardStepCollection Insert Example</title>
</head>
<body>
    <form id="Form1" runat="server">
      <h3>WizardStepCollection Insert Example</h3>
      <asp:PlaceHolder id="PlaceHolder1" 
        runat="server" />
    </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">

  ' Programmatically create a Wizard control and dynamically
  ' add WizardStep objects to it.    
  
  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    Dim WizardControl As Wizard = New Wizard()
      
    ' Create some steps for the wizard and insert them
    ' into the WizardStepCollection collection.
    For i As Integer = 0 To 5
      Dim newStep As WizardStepBase = New WizardStep()
      newStep.ID = "Step" + (i + 1).ToString()
      WizardControl.WizardSteps.Insert(0, newStep)
    Next

    WizardControl.ActiveStepIndex = 0
    WizardControl.DisplaySideBar = True
    
    ' Display the wizard on the page.
    PlaceHolder1.Controls.Add(WizardControl)
  
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>WizardStepCollection Insert Example</title>
</head>
<body>
    <form id="Form1" runat="server">
      <h3>WizardStepCollection Insert Example</h3>
      <asp:PlaceHolder id="PlaceHolder1" 
        runat="server" />
    </form>
  </body>
</html>

Comentários

O Insert método adiciona o WizardStepBaseobjeto derivado à coleção no local de índice especificado.

Como alternativa, você pode usar o AddAt método para adicionar o WizardStepBaseobjeto derivado à coleção. Para adicionar um WizardStepBaseobjeto derivado ao final da WizardStepCollection coleção, use o Add método.

Observação

O Insert método e o AddAt método executam essencialmente a mesma função. Quando o Insert método é chamado, ele simplesmente passa os parâmetros e index o wizardStep método.AddAt

Aplica-se a

Confira também