HtmlTextArea.OnServerChange(EventArgs) Metodo

Definizione

Genera l'evento ServerChange del HtmlTextArea controllo . In questo modo è possibile fornire un gestore personalizzato per l'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)

Parametri

e
EventArgs

Oggetto EventArgs contenente i dati dell'evento.

Esempio

Nell'esempio di codice seguente viene illustrato come specificare e creare un gestore eventi personalizzato per l'evento ServerChange . Un messaggio viene visualizzato quando il valore immesso nel HtmlTextArea controllo supera i 20 caratteri.

<%@ 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>

Commenti

L'evento ServerChange viene generato quando il contenuto del HtmlTextArea controllo cambia tra i post nel server.

Note

Questo evento viene generato solo quando l'utente avvia un post nel server, ad esempio facendo clic su un submit pulsante. Questo evento non causa l'esecuzione di un post nel server.

Note

Per il corretto funzionamento dell'evento, il ServerChange controllo deve disporre dello stato di visualizzazione abilitato.

Questo evento viene comunemente usato per eseguire la convalida dei dati sul HtmlTextArea controllo quando l'utente aggiorna il testo nel controllo.

La generazione di un evento richiama il gestore eventi tramite un delegato. Per altre informazioni, vedere Gestione e generazione di eventi.

Il OnServerChange metodo consente anche alle classi derivate di gestire l'evento senza associare un delegato. Questa è la tecnica preferita per gestire l'evento in una classe derivata.

Note per gli eredi

Quando si esegue l'override OnServerChange(EventArgs) in una classe derivata, assicurarsi di chiamare il metodo della OnServerChange(EventArgs) classe di base in modo che i delegati registrati ricevano l'evento.

Si applica a

Vedi anche