HtmlTextArea.OnServerChange(EventArgs) Método

Referencia

Definición

Espacio de nombres:: System.Web.UI.HtmlControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Provoca el evento ServerChange del control HtmlTextArea. Esto permite incluir un control personalizado para el evento.

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)

Parámetros

e: EventArgs

Objeto EventArgs que contiene los datos del evento.

Ejemplos

En el ejemplo de código siguiente se muestra cómo especificar y crear un controlador de eventos personalizado para el ServerChange evento. Se muestra un mensaje cuando el valor especificado en el HtmlTextArea control supera los 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>

Comentarios

El ServerChange evento se genera cuando el contenido del HtmlTextArea control cambia entre publicaciones en el servidor.

Nota

Este evento solo se genera cuando el usuario inicia una publicación en el servidor, como haciendo clic en un submit botón. Este evento no hace que se produzca una publicación en el servidor.

Nota

El control debe tener viewstate habilitado para que el ServerChange evento funcione correctamente.

Este evento se usa normalmente para realizar la validación de datos en el HtmlTextArea control cuando el usuario actualiza el texto del control.

Cuando se genera un evento, se invoca el controlador de eventos a través de un delegado. Para obtener más información, consulte controlar y provocar eventos.

El método OnServerChange también permite que las clases derivadas controlen el evento sin adjuntar ningún delegado. Ésta es la técnica preferida para controlar el evento en una clase derivada.

Notas a los desarrolladores de herederos

Al reemplazar OnServerChange(EventArgs) en una clase derivada, asegúrese de llamar al método OnServerChange(EventArgs) de la clase base para que los delegados registrados reciban el evento.

Se aplica a

Compartir a través de