HtmlAnchor.OnServerClick(EventArgs) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывает событие ServerClick. Это позволяет предоставить настраиваемый обработчик для события.
protected:
virtual void OnServerClick(EventArgs ^ e);
protected virtual void OnServerClick (EventArgs e);
abstract member OnServerClick : EventArgs -> unit
override this.OnServerClick : EventArgs -> unit
Protected Overridable Sub OnServerClick (e As EventArgs)
Параметры
Примеры
В следующем примере кода показано, как декларативно указать и закодировать обработчик ServerClick события. При щелчке HtmlAnchor элемента управления отображается сообщение.
<%@ 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>
<%@ Page Language="VB" 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">
Sub HtmlAnchor_Click(sender As Object, e As EventArgs)
Message.InnerHtml = "Thank you for clicking the HtmlAnchor control."
End Sub
</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>
Следующий пример кода изменяет предыдущий пример, чтобы программно указать и кодировать обработчик событий для ServerClick события.
<%@ 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>
<%@ Page Language="VB" 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">
Sub Page_Load(sender As Object, e As EventArgs)
' 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.
AddHandler AnchorButton.ServerClick, AddressOf HtmlAnchor_Click
End Sub
Sub HtmlAnchor_Click(sender As Object, e As EventArgs)
Message.InnerHtml = "Thank you for clicking the HtmlAnchor control."
End Sub
</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>
Комментарии
Событие ServerClick возникает при щелчке HtmlAnchor элемента управления. Это событие сервера приводит к возникновению кругового пути от клиента к серверу и обратно.
При возникновении события через делегат вызывается обработчик события. Дополнительные сведения см. в разделе Обработка и вызов событий.
Метод OnServerClick также позволяет производным классам обрабатывать событие, не присоединяя делегат. Это предпочтительная методика обработки событий в производном классе.
Примечания для тех, кто наследует этот метод
При переопределении метода OnServerClick(EventArgs) в производном классе нужно убедиться, что вызывается метод OnServerClick(EventArgs) базового класса, чтобы зарегистрированные делегаты получили событие.