HtmlTextArea.OnServerChange(EventArgs) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Genera l'evento ServerChange del controllo HtmlTextArea. In tal 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 -> unitProtected Overridable Sub OnServerChange (e As EventArgs)Parametri
Esempio
Nell'esempio di codice seguente viene illustrato come specificare e creare un gestore eventi personalizzato per l'evento ServerChange . Viene visualizzato un messaggio 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 viene modificato tra i post nel server.
Nota
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.
Nota
Per il corretto funzionamento dell'evento, è necessario che il ServerChange controllo abbia lo 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 .
Quando viene generato un evento, il gestore dell'evento viene richiamato tramite un delegato. Per altre informazioni, vedere la gestione e generazione di eventi.
Il metodo OnServerChange consente inoltre alle classi derivate di gestire l'evento senza associare un delegato. È la tecnica consigliata per la gestione dell'evento in una classe derivata.
Note per gli eredi
Quando si esegue l'override di OnServerChange(EventArgs) in una classe derivata, verificare di chiamare il metodo OnServerChange(EventArgs) della classe di base in modo che i delegati registrati ricevano l'evento.
