Wizard.OnSideBarButtonClick(WizardNavigationEventArgs) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Eleva o SideBarButtonClick evento.
protected:
virtual void OnSideBarButtonClick(System::Web::UI::WebControls::WizardNavigationEventArgs ^ e);
protected virtual void OnSideBarButtonClick(System.Web.UI.WebControls.WizardNavigationEventArgs e);
abstract member OnSideBarButtonClick : System.Web.UI.WebControls.WizardNavigationEventArgs -> unit
override this.OnSideBarButtonClick : System.Web.UI.WebControls.WizardNavigationEventArgs -> unit
Protected Overridable Sub OnSideBarButtonClick (e As WizardNavigationEventArgs)
Parâmetros
A WizardNavigationEventArgs contendo dados de eventos.
Exemplos
O exemplo de código seguinte demonstra como especificar um gestor de eventos para o SideBarButtonClick evento. Cada vez que o SideBarButtonClick evento é levantado, é escrita uma mensagem na Text propriedade para Label1 com informações sobre qual botão de área na barra lateral foi clicado.
<%@ 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 OnSideBarButtonClick(object sender, WizardNavigationEventArgs e)
{
// When a button in the sidebar area is clicked, put a message
// in Label1 to be displayed in the header area.
Label tempLabel = (Label)Wizard1.FindControl("Label1");
if (tempLabel != null)
{
tempLabel.Text = "You clicked the button for Step " +
(e.NextStepIndex + 1) + ".";
}
}
</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"
onsidebarbuttonclick="OnSideBarButtonClick">
<WizardSteps>
<asp:WizardStep id="WizardStep1"
runat="server"
title="Step 1">
</asp:WizardStep>
<asp:WizardStep id="WizardStep2"
runat="server"
title="Step 2">
</asp:WizardStep>
<asp:WizardStep id="WizardStep3"
runat="server"
title="Step 3">
</asp:WizardStep>
</WizardSteps>
<HeaderTemplate>
<b>SideBarButtonClick Example</b>
<br />
<asp:Label id="Label1"
runat="server"
width="208px"
height="19px">
</asp:Label>
</HeaderTemplate>
</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 OnSideBarButtonClick(ByVal sender As Object, ByVal e As WizardNavigationEventArgs)
' When a button in the sidebar area is clicked, put a message
' in Label1 to be displayed in the header area.
Dim tempLabel As Label = CType(Wizard1.FindControl("Label1"), Label)
If Not tempLabel Is Nothing Then
tempLabel.Text = "You clicked the button for Step " & _
(e.NextStepIndex + 1) & "."
End If
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"
onsidebarbuttonclick="OnSideBarButtonClick">
<WizardSteps>
<asp:WizardStep id="WizardStep1"
runat="server"
title="Step 1">
</asp:WizardStep>
<asp:WizardStep id="WizardStep2"
runat="server"
title="Step 2">
</asp:WizardStep>
<asp:WizardStep id="WizardStep3"
runat="server"
title="Step 3">
</asp:WizardStep>
</WizardSteps>
<HeaderTemplate>
<b>SideBarButtonClick Example</b>
<br />
<asp:Label id="Label1"
runat="server"
width="208px"
height="19px">
</asp:Label>
</HeaderTemplate>
</asp:Wizard>
</form>
</body>
</html>
Observações
O SideBarButtonClick evento é ativado quando um botão na barra lateral é clicado.
Note
O SideBarButtonClick evento não gera um evento se um Button controlo com a CommandName propriedade definida para Move estiver fora da DataList lista lateral do controlo para o SideBarTemplate objeto.
Levantar um evento invoca o gestor de eventos através de um delegado. Para mais informações, consulte Manuseio e Levantamento de Eventos.
O OnSideBarButtonClick método também permite que classes derivadas tratem do evento sem anexar um delegado. Esta é a técnica preferida para lidar com o evento numa classe derivada.
Notas para Herdeiros
Ao sobrepor o OnSideBarButtonClick(WizardNavigationEventArgs) método numa classe derivada, certifique-se de chamar o OnSideBarButtonClick(WizardNavigationEventArgs) método da classe base para que os delegados registados recebam o evento.