Wizard.OnActiveStepChanged(Object, EventArgs) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Aciona o 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
A fonte do evento.
Exemplos
O exemplo de código a Wizard seguir demonstra como usar o ActiveStepChanged evento para atualizar a HeaderText propriedade do controle.
<%@ 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>
Comentários
O OnActiveStepChanged método gera o ActiveStepChanged evento quando a ActiveStep propriedade do Wizard controle é alterada. Use o ActiveStepChanged evento para fornecer processamento adicional quando a etapa atual exibida no Wizard controle for alterada.
A geração de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações, consulte Manipulando e levantando eventos.
O OnActiveStepChanged método também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.
Notas aos Herdeiros
Ao substituir o OnActiveStepChanged(Object, EventArgs) método em uma classe derivada, chame o OnActiveStepChanged(Object, EventArgs) método da classe base para que os delegados registrados recebam o evento.