Wizard.OnSideBarButtonClick(WizardNavigationEventArgs) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Raises the SideBarButtonClick event.
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)
Parameters
A WizardNavigationEventArgs containing event data.
Examples
The following code example demonstrates how to specify an event handler for the SideBarButtonClick event. Each time the SideBarButtonClick event is raised, a message is written to the Text property for Label1
with information on which sidebar area button was clicked.
<%@ 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>
Remarks
The SideBarButtonClick event is raised when a button on the sidebar area is clicked.
Note
The SideBarButtonClick event does not raise an event if a Button control with the CommandName property set to Move
is outside of the DataList control's sidebar list for the SideBarTemplate object.
Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.
The OnSideBarButtonClick method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.
Notes to Inheritors
When overriding the OnSideBarButtonClick(WizardNavigationEventArgs) method in a derived class, be sure to call the OnSideBarButtonClick(WizardNavigationEventArgs) method of the base class so that registered delegates receive the event.