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 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 .