Wizard.OnCancelButtonClick(EventArgs) Método
Definição
Aciona o evento CancelButtonClick.Raises the CancelButtonClick event.
protected:
virtual void OnCancelButtonClick(EventArgs ^ e);
protected virtual void OnCancelButtonClick (EventArgs e);
abstract member OnCancelButtonClick : EventArgs -> unit
override this.OnCancelButtonClick : EventArgs -> unit
Protected Overridable Sub OnCancelButtonClick (e As EventArgs)
Parâmetros
Exemplos
O exemplo de código a seguir demonstra como especificar um manipulador de eventos para o CancelButtonClick evento.The following code example demonstrates how to specify an event handler for the CancelButtonClick event. Quando o botão Cancelar é clicado, a etapa é redirecionada para http://www.wingtiptoys.com/ .When the Cancel button is clicked, the step is redirected to http://www.wingtiptoys.com/.
<%@ 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 OnCancelButtonClick(object sender, EventArgs e)
{
// When the Cancel button is clicked, redirect to http://www.wingtiptoys.com/.
Response.Redirect("http://www.wingtiptoys.com/");
}
</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"
displaycancelbutton="True"
oncancelbuttonclick="OnCancelButtonClick">
<WizardSteps>
<asp:WizardStep title="Step 1"
runat="server">
</asp:WizardStep>
<asp:WizardStep title="Step 2"
runat="server">
</asp:WizardStep>
</WizardSteps>
<HeaderTemplate>
<b>CancelButtonClick Example</b>
</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 OnCancelButtonClick(ByVal sender As Object, ByVal e As EventArgs)
' When the Cancel button is clicked, redirect to http://www.wingtiptoys.com/.
Response.Redirect("http://www.wingtiptoys.com/")
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"
displaycancelbutton="True"
oncancelbuttonclick="OnCancelButtonClick">
<HeaderTemplate>
<b>CancelButtonClick Example</b>
</HeaderTemplate>
<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>
Comentários
O CancelButtonClick evento é gerado quando o botão de cancelamento é clicado.The CancelButtonClick event is raised when the Cancel button is clicked.
A geração de um evento invoca o manipulador de eventos por meio de um delegado.Raising an event invokes the event handler through a delegate. Para obter mais informações, consulte manipulando e gerando eventos.For more information, see Handling and Raising Events.
O OnCancelButtonClick método também permite que classes derivadas manipulem o evento sem anexar um delegado.The OnCancelButtonClick method also allows derived classes to handle the event without attaching a delegate. Essa é a técnica preferida para manipular o evento em uma classe derivada.This is the preferred technique for handling the event in a derived class.
Notas aos Herdeiros
Ao substituir o OnCancelButtonClick(EventArgs) método em uma classe derivada, certifique-se de chamar o OnCancelButtonClick(EventArgs) método da classe base para que os delegados registrados recebam o evento.When overriding the OnCancelButtonClick(EventArgs) method in a derived class, be sure to call the OnCancelButtonClick(EventArgs) method of the base class so that registered delegates receive the event.