Wizard.OnActiveStepChanged(Object, EventArgs) 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í.
Genera el evento ActiveStepChanged.
protected:
virtual void OnActiveStepChanged(System::Object ^ source, EventArgs ^ e);
protected virtual void OnActiveStepChanged (object source, EventArgs e);
abstract member OnActiveStepChanged : obj * EventArgs -> unit
override this.OnActiveStepChanged : obj * EventArgs -> unit
Protected Overridable Sub OnActiveStepChanged (source As Object, e As EventArgs)
Parámetros
- source
- Object
Origen del evento.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar el ActiveStepChanged evento para actualizar la HeaderText propiedad del Wizard control.
<%@ 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)
{
// Every time that the ActiveStep property changes, change the HeaderText to match it.
Wizard1.HeaderText = "You are currently on " + Wizard1.ActiveStep.Title;
}
</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"
HeaderText="ActiveStepChanged Example">
<WizardSteps>
<asp:WizardStep Title="Step 1"
Runat="server">
</asp:WizardStep>
<asp:WizardStep Title="Step 2"
Runat="server">
</asp:WizardStep>
</WizardSteps>
</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 System.EventArgs)
' Every time that the ActiveStep property changes, change the HeaderText to match it.
Wizard1.HeaderText = "You are currently on " + Wizard1.ActiveStep.Title
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"
HeaderText="ActiveStepChanged Example">
<WizardSteps>
<asp:WizardStep ID="WizardStep1" Title="Step 1"
Runat="server">
</asp:WizardStep>
<asp:WizardStep ID="WizardStep2" Title="Step 2"
Runat="server">
</asp:WizardStep>
</WizardSteps>
</asp:Wizard>
</form>
</body>
</html>
Comentarios
El OnActiveStepChanged método genera el ActiveStepChanged evento cuando se cambia la ActiveStep propiedad del Wizard control. Use el ActiveStepChanged evento para proporcionar procesamiento adicional cuando cambie el paso actual que se muestra en el Wizard control.
Cuando se genera un evento, se invoca el controlador de eventos a través de un delegado. Para obtener más información, consulte controlar y provocar eventos.
El método OnActiveStepChanged también permite que las clases derivadas controlen el evento sin adjuntar ningún delegado. Ésta es la técnica preferida para controlar el evento en una clase derivada.
Notas a los desarrolladores de herederos
Al invalidar el OnActiveStepChanged(Object, EventArgs) método en una clase derivada, asegúrese de llamar al OnActiveStepChanged(Object, EventArgs) método de la clase base para que los delegados registrados reciban el evento.