WizardStepCollection.Insert(Int32, WizardStepBase) Método

Definición

Inserta el objeto especificado derivado de WizardStepBase en la ubicación de índice especificada de la colección.

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

Ubicación de índice en la que se va a insertar el objeto derivado de WizardStepBase.

wizardStep
WizardStepBase

Objeto derivado de WizardStepBase que se va a insertar en la colección WizardStepCollection.

Ejemplos

En el ejemplo de código siguiente se muestra la creación de un Wizard control mediante programación y el uso del Insert método para agregar WizardStepBaseobjetos derivados de la WizardSteps colección. Tenga en cuenta que, en el ejemplo, la WizardSteps propiedad del Wizard control es una instancia de la WizardStepCollection clase .

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

Comentarios

El Insert método agrega el WizardStepBaseobjeto derivado de a la colección en la ubicación de índice especificada.

Como alternativa, puede usar el AddAt método para agregar el WizardStepBaseobjeto derivado de a la colección. Para agregar un WizardStepBaseobjeto derivado de al final de la WizardStepCollection colección, use el Add método .

Nota:

El Insert método y el AddAt método realizan esencialmente la misma función. Cuando se llama al Insert método , simplemente pasa los wizardStep parámetros y index al AddAt método .

Se aplica a

Consulte también