Wizard.OnSideBarButtonClick(WizardNavigationEventArgs) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
引發 SideBarButtonClick 事件。
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)
參數
範例
下列程式代碼範例示範如何指定 事件的事件處理程式 SideBarButtonClick 。 每次引發事件時 SideBarButtonClick ,都會將訊息寫入 屬性, Text 其中包含 Label1
按下提要字段區域按鈕的資訊。
<%@ 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>
備註
SideBarButtonClick按兩下提要欄位區域上的按鈕時,就會引發事件。
注意
如果 Button 屬性設定為 Move
的CommandName控件不在 物件的控件提要字段清單SideBarTemplate之外DataList,則SideBarButtonClick事件不會引發事件。
引發事件會透過委派叫用此事件處理常式。 如需詳細資訊,請參閱 處理和引發事件。
OnSideBarButtonClick 方法也允許衍生類別處理事件,而不用附加委派。 這是在衍生類別中處理事件的慣用技巧。
給繼承者的注意事項
在 OnSideBarButtonClick(WizardNavigationEventArgs) 衍生類別中覆寫 方法時,請務必呼叫 OnSideBarButtonClick(WizardNavigationEventArgs) 基類的方法,讓已註冊的委派接收 事件。