Freigeben über


HtmlInputText.OnServerChange-Methode

Löst das ServerChange-Ereignis aus.

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

Hinweise

Das ServerChange-Ereignis wird ausgelöst, wenn die Value-Eigenschaft auf dem Server geändert wird.

Hinweis

Der Ansichtszustand für das Steuerelement muss aktiviert sein, damit das ServerChange-Ereignis ordnungsgemäß funktioniert.

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 das Angeben und Codieren eines Handlers für das ServerChange-Ereignis veranschaulicht. Der benutzerdefinierte Ereignishandler aktualisiert eine Bezeichnung auf der Webseite, um den Wert des im <input type=text>-HTML-Element eingegebenen Textes anzuzeigen.

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">

     Sub Server_Change(ByVal sender As Object, ByVal e As EventArgs)

       Span1.InnerHtml = String.Format("You typed: {0}", Text1.Value)

     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 Text1.ServerChange, AddressOf Server_Change
      
     End Sub

   </script>

</head>

<body>

   <form runat="server">

      <h3>HtmlInputText ServerChange Example</h3>

      Enter a value in the input field below and 
      click the Submit button.

      <br>

      <input type="text" 
             id="Text1" 
             runat="server"/>
      <br>

      <input type="submit" 
             id="Button1" 
             value="Submit" 
             runat="server"/>

      <p>

      <span id="Span1" 
            runat="server" />

   </form>

</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">

      void Server_Change(object sender, EventArgs e) 
      {
         Span1.InnerHtml = "You typed: " + Text1.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.
         Text1.ServerChange += new System.EventHandler(this.Server_Change);
      }         

   </script>

</head>

<body>

   <form runat="server">

      <h3>HtmlInputText ServerChange Example</h3>

      Enter a value in the input field below and 
      click the Submit button.

      <br>

      <input type="text" 
             id="Text1" 
             runat="server"/>
      <br>

      <p>

      <input type="submit" 
             id="Button1" 
             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

HtmlInputText-Klasse
HtmlInputText-Member
System.Web.UI.HtmlControls-Namespace
ServerChange

Weitere Ressourcen

HTML-Serversteuerelemente