HtmlTextArea.OnServerChange-Methode
Löst das ServerChange-Ereignis des HtmlTextArea-Steuerelements aus. Dadurch können Sie einen benutzerdefinierten Handler für das Ereignis bereitstellen.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Protected Overridable Sub OnServerChange ( _
e As EventArgs _
)
'Usage
Dim e As EventArgs
Me.OnServerChange(e)
protected virtual void OnServerChange (
EventArgs e
)
protected:
virtual void OnServerChange (
EventArgs^ e
)
protected void OnServerChange (
EventArgs e
)
protected function OnServerChange (
e : EventArgs
)
Parameter
- e
Ein System.EventArgs, das die Ereignisdaten enthält.
Hinweise
Das ServerChange-Ereignis wird ausgelöst, wenn der Inhalt des HtmlTextArea-Steuerelements zwischen Bereitstellungen auf dem Server geändert wird.
Hinweis
Dieses Ereignis wird nur ausgelöst, wenn der Benutzer eine Bereitstellung auf dem Server initiiert, z. B. durch Klicken auf eine Schaltfläche zum Senden submit. Dieses Ereignis bewirkt keine Bereitstellung auf dem Server.
Hinweis
Für das Steuerelement muss der Ansichtszustand aktiviert sein, damit das ServerChange-Ereignis ordnungsgemäß funktioniert.
Dieses Ereignis wird i. d. R. verwendet, um eine Datenvalidierung im HtmlTextArea-Steuerelement durchzuführen, wenn der Benutzer den Text im Steuerelement aktualisiert.
Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Auslösen eines Ereignisses.
Die OnServerChange-Methode ermöglicht es auch abgeleiteten Klassen, das Ereignis ohne Anfügen eines Delegaten zu behandeln. Dies ist das bevorzugte Verfahren für die Behandlung des Ereignisses in einer abgeleiteten Klasse.
Hinweise für Erben Wenn Sie OnServerChange in einer abgeleiteten Klasse überschreiben, müssen Sie unbedingt die OnServerChange-Methode der Basisklasse aufrufen, sodass registrierte Delegaten das Ereignis empfangen.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie für das ServerChange-Ereignis ein benutzerdefinierter Ereignishandler angegeben und erstellt wird. Wenn der im HtmlTextArea-Steuerelement eingegebene Wert 20 Zeichen übersteigt, wird eine Meldung ausgegeben.
<%@ Page Language="VB" AutoEventWireup="True" %>
<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>
<head>
<title>HtmlTextArea ServerChange Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTextArea ServerChange Example</h3>
Enter your comments: <br>
<textarea id="TextArea1"
OnServerChange="Server_Change"
runat="server"/>
<br>
<input type="submit"
value="Submit"
runat="server"/>
<p>
<span id="Span1"
runat="server" />
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<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>
<head>
<title>HtmlTextArea ServerChange Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTextArea ServerChange Example</h3>
Enter your comments: <br>
<textarea id="TextArea1"
onserverchange="Server_Change"
runat="server"/>
<br>
<input type="submit"
value="Submit"
runat="server"/>
<p>
<span id="Span1"
runat="server" />
</form>
</body>
</html>
<%@ Page Language="JScript" AutoEventWireup="True" %>
<script runat="server">
function Server_Change(sender, e : 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)
Span1.InnerHtml = "Your comment cannot exceed 20 characters.";
else
Span1.InnerHtml = "You wrote: <br>" + TextArea1.Value;
}
</script>
<html>
<head>
<title>HtmlTextArea ServerChange Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTextArea ServerChange Example</h3>
Enter your comments: <br>
<textarea id="TextArea1"
onserverchange="Server_Change"
runat="server"/>
<br>
<input type="submit"
value="Submit"
runat="server"/>
<p>
<span id="Span1"
runat="server" />
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<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>
<head>
<title>HtmlTextArea ServerChange Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTextArea ServerChange Example</h3>
Enter your comments (20 or fewer characters): <br>
<textarea id="TextArea1"
runat="server"/>
<br>
<input type="submit"
value="Submit"
runat="server"/>
<p>
<span id="Span1"
runat="server" />
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<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>
<head>
<title>HtmlTextArea ServerChange Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTextArea ServerChange Example</h3>
Enter your comments (20 or fewer characters): <br>
<textarea id="TextArea1"
runat="server"/>
<br>
<input type="submit"
value="Submit"
runat="server"/>
<p>
<span id="Span1"
runat="server" />
</form>
</body>
</html>
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
HtmlTextArea-Klasse
HtmlTextArea-Member
System.Web.UI.HtmlControls-Namespace
ServerChange
System.EventArgs