HtmlTextArea.OnServerChange(EventArgs) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Aciona o evento ServerChange do controle HtmlTextArea. Isso permite que você forneça um manipulador personalizado para o evento.
protected:
virtual void OnServerChange(EventArgs ^ e);protected virtual void OnServerChange (EventArgs e);abstract member OnServerChange : EventArgs -> unit
override this.OnServerChange : EventArgs -> unitProtected Overridable Sub OnServerChange (e As EventArgs)Parâmetros
Exemplos
O exemplo de código a seguir demonstra como especificar e criar um manipulador de eventos personalizado para o ServerChange evento. Uma mensagem é exibida quando o valor inserido no HtmlTextArea controle excede 20 caracteres.
<%@ 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>
Comentários
O ServerChange evento é gerado quando o conteúdo do HtmlTextArea controle é alterado entre postagens no servidor.
Observação
Esse evento só é gerado quando o usuário inicia uma postagem no servidor, como clicando em um submit botão. Esse evento não faz com que uma postagem no servidor ocorra.
Observação
O controle deve ter viewstate habilitado para que o ServerChange evento funcione corretamente.
Esse evento é comumente usado para executar a validação de dados no HtmlTextArea controle quando o usuário atualiza o texto no controle.
A geração de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações, consulte Manipulando e levantando eventos.
O OnServerChange método também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.
Notas aos Herdeiros
Ao substituir OnServerChange(EventArgs) em uma classe derivada, chame o método da OnServerChange(EventArgs) classe base para que os delegados registrados recebam o evento.
