WizardStepCollection.Insert(Int32, WizardStepBase) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inserta el objeto derivado especificado WizardStepBaseen la colección en la ubicación de índice especificada.
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 del índice en la que se va a insertar el WizardStepBaseobjeto derivado de .
- wizardStep
- WizardStepBase
Objeto WizardStepBasederivado del que se va a insertar en la WizardStepCollection colección.
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 a 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 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 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 .