HtmlTextArea.OnServerChange(EventArgs) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Вызывает событие ServerChange элемента управления HtmlTextArea. Это позволяет предоставить настраиваемый обработчик для события.
protected:
virtual void OnServerChange(EventArgs ^ e);
protected virtual void OnServerChange (EventArgs e);
abstract member OnServerChange : EventArgs -> unit
override this.OnServerChange : EventArgs -> unit
Protected Overridable Sub OnServerChange (e As EventArgs)
Параметры
Примеры
В следующем примере кода показано, как указать и создать пользовательский обработчик событий для ServerChange события. Сообщение отображается, если значение, введенное в элементе HtmlTextArea управления, превышает 20 символов.
<%@ 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">
<script runat="server">
void Server_Change(Object sender, EventArgs e)
{
// The ServerChange event is commonly used for data validation.
// This method determines whether the comment entered into the
// HtmlTextArea control is longer than 20 characters.
if (TextArea1.Value.Length > 20)
Span1.InnerHtml = "Your comment cannot exceed 20 characters.";
else
Span1.InnerHtml = "You wrote: <br />" + TextArea1.Value;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTextArea ServerChange Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTextArea ServerChange Example</h3>
Enter your comments: <br />
<textarea rows="2" cols="20" id="TextArea1"
onserverchange="Server_Change"
runat="server"/>
<br />
<input type="submit"
value="Submit"
runat="server"/>
<br />
<span id="Span1"
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">
<script runat="server">
Sub Server_Change(ByVal sender As Object, ByVal e As EventArgs)
' The ServerChange event is commonly used for data validation.
' This method determines whether the comment entered into the
' HtmlTextArea control is longer than 20 characters.
If TextArea1.Value.Length > 20 Then
Span1.InnerHtml = "Your comment cannot exceed 20 characters."
Else
Span1.InnerHtml = "You wrote: <br />" + TextArea1.Value
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTextArea ServerChange Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTextArea ServerChange Example</h3>
Enter your comments: <br />
<textarea rows="2" cols="20" id="TextArea1"
onserverchange="Server_Change"
runat="server"/>
<br />
<input type="submit"
value="Submit"
runat="server"/>
<br />
<span id="Span1"
runat="server" />
</form>
</body>
</html>
<%@ 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">
<script runat="server">
void Server_Change(Object sender, EventArgs e)
{
// The ServerChange event is commonly used for data validation.
// This method determines whether the comment entered into the
// HtmlTextArea control is longer than 20 characters.
if (TextArea1.Value.Length > 20)
{
Span1.InnerHtml = "Your comment cannot exceed 20 characters.";
}
else
{
Span1.InnerHtml = "You wrote: <br />" + TextArea1.Value;
}
}
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.
TextArea1.ServerChange +=
new System.EventHandler(this.Server_Change);
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTextArea ServerChange Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTextArea ServerChange Example</h3>
Enter your comments (20 or fewer characters): <br />
<textarea rows="2" cols="20" id="TextArea1"
runat="server"/>
<br />
<input type="submit"
value="Submit"
runat="server"/>
<br />
<span id="Span1"
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">
<script runat="server">
Sub Server_Change(ByVal sender As Object, ByVal e As EventArgs)
' The ServerChange event is commonly used for data validation.
' This method determines whether the comment entered into the
' HtmlTextArea control is longer than 20 characters.
If TextArea1.Value.Length > 20 Then
Span1.InnerHtml = "Your comment cannot exceed 20 characters."
Else
Span1.InnerHtml = "You wrote: <br />" + TextArea1.Value
End If
End Sub
Sub Page_Load(ByVal sender As Object, ByVal 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 TextArea1.ServerChange, AddressOf Server_Change
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>HtmlTextArea ServerChange Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlTextArea ServerChange Example</h3>
Enter your comments (20 or fewer characters): <br />
<textarea rows="2" cols="20" id="TextArea1"
runat="server"/>
<br />
<input type="submit"
value="Submit"
runat="server"/>
<br />
<span id="Span1"
runat="server" />
</form>
</body>
</html>
Комментарии
Событие ServerChange возникает при изменении содержимого HtmlTextArea элемента управления между публикациями на сервере.
Примечание
Это событие возникает только при инициировании пользователем публикации на сервере, например при нажатии кнопки submit
. Это событие не приводит к отправке на сервер.
Примечание
Для правильной ServerChange работы события в элементе управления должно быть включено состояние просмотра.
Это событие обычно используется для проверки данных в элементе HtmlTextArea управления, когда пользователь обновляет текст в элементе управления .
При возникновении события через делегат вызывается обработчик события. Дополнительные сведения см. в разделе Обработка и вызов событий.
Метод OnServerChange также позволяет производным классам обрабатывать событие, не присоединяя делегат. Это предпочтительная методика обработки событий в производном классе.
Примечания для тех, кто наследует этот метод
При переопределении метода OnServerChange(EventArgs) в производном классе нужно убедиться, что вызывается метод OnServerChange(EventArgs) базового класса, чтобы зарегистрированные делегаты получили событие.