HtmlAnchor.OnServerClick Method (EventArgs)

 

Raises the ServerClick event. This allows you to provide a custom handler for the event.

Namespace:   System.Web.UI.HtmlControls
Assembly:  System.Web (in System.Web.dll)

protected virtual void OnServerClick(
	EventArgs e
)

Parameters

e
Type: System.EventArgs

An System.EventArgs that contains event data.

The ServerClick event is raised when the HtmlAnchor control is clicked. This server event causes a round trip to occur from the client to the server and back.

Raising an event invokes the event handler through a delegate. For more information, see NIB: Raising an Event.

The OnServerClick 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 OnServerClick in a derived class, be sure to call the base class's OnServerClick method so that registered delegates receive the event.

The following code example demonstrates how to declaratively specify and code an event handler for the ServerClick event. When the HtmlAnchor control is clicked, a message is displayed.


<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" > 

<head>
    <title> HtmlAnchor ServerClick Event Example </title>
<script runat="server">

      void HtmlAnchor_Click(Object sender, EventArgs e)
      {

         Message.InnerHtml = "Thank you for clicking the HtmlAnchor control.";

      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3> HtmlAnchor ServerClick Event Example </h3>

      <a id="AnchorButton"
         onserverclick="HtmlAnchor_Click"
         runat="server">

         Click Here

      </a>

      <br /><br />

      <span id="Message" runat="server"/>

   </form>

</body>
</html>

The following code example modifies the preceding example to programmatically specify and code an event handler for the ServerClick event.


<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" > 

<head>
    <title> HtmlAnchor ServerClick Event Example </title>
<script runat="server">

      void Page_Load(Object sender, EventArgs e)
      {

         // Create an EventHandler delegate for the method you want to handle the event
         // and then add it to the list of methods called when the event is raised.
         AnchorButton.ServerClick += new System.EventHandler(this.HtmlAnchor_Click);

      }

      void HtmlAnchor_Click(Object sender, EventArgs e)
      {

         Message.InnerHtml = "Thank you for clicking the HtmlAnchor control.";

      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3> HtmlAnchor ServerClick Event Example </h3>

      <a id="AnchorButton"
         runat="server">

         Click Here

      </a>

      <br /><br />

      <span id="Message" runat="server"/>

   </form>

</body>
</html>

.NET Framework
Available since 1.1
Return to top
Show: