TextBox.OnTextChanged-Methode

Artikel
08/20/2007

Löst das TextChanged-Ereignis aus. Dadurch können Sie das Ereignis direkt behandeln.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Overridable Sub OnTextChanged ( _
    e As EventArgs _
)
'Usage
Dim e As EventArgs

Me.OnTextChanged(e)

protected virtual void OnTextChanged (
    EventArgs e
)

protected:
virtual void OnTextChanged (
    EventArgs^ e
)

protected void OnTextChanged (
    EventArgs e
)

protected function OnTextChanged (
    e : EventArgs
)

Parameter

e
Eine Instanz von EventArgs, die Ereignisdaten enthält.

Hinweise

Das TextChanged-Ereignis wird ausgelöst, wenn der Inhalt des Textfelds zwischen Übertragungen zum Server geändert wird.

Hinweis

Ein TextBox-Steuerelement muss zwischen Übertragungen zum Server einige Werte beibehalten, damit dieses Ereignis ordnungsgemäß funktioniert. Der Ansichtszustand für dieses Steuerelement muss aktiviert sein.

Durch das Auslösen eines Ereignisses wird der Ereignishandler über einen Delegaten aufgerufen. Weitere Informationen finden Sie unter Auslösen eines Ereignisses.

Die OnTextChanged-Methode ermöglicht es abgeleiteten Klassen auch, 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 Beim Überschreiben von OnTextChanged in einer abgeleiteten Klasse müssen Sie sicherstellen, dass die OnTextChanged-Methode der Basisklasse aufgerufen wird, damit registrierte Delegaten das Ereignis empfangen.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie die OnTextChanged-Methode so überschrieben wird, dass sie stets ein benutzerdefiniertes TextBox-Serversteuerelement als geändert kennzeichnet.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom TextBox - OnTextChanged - VB.NET Example</title>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom TextBox - OnTextChanged - VB.NET Example</h3>
            
            <aspSample:CustomTextBoxOnTextChanged id="TextBox1" autopostback=true
             runat="server">Hello World!</aspSample:CustomTextBoxOnTextChanged>
        </form>
    </body>
</HTML>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom TextBox - OnTextChanged - C# Example</title>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom TextBox - OnTextChanged - C# Example</h3>
            
            <aspSample:CustomTextBoxOnTextChanged 
              id="TextBox1" 
              autopostback=true
              runat="server">Hello World!
            </aspSample:CustomTextBoxOnTextChanged>
            
        </form>
    </body>
</HTML>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
    <HEAD>
        <title>Custom TextBox - OnTextChanged - VJ# Example</title>
    </HEAD>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom TextBox - OnTextChanged - VJ# Example</h3>
            
            <aspSample:CustomTextBoxOnTextChanged 
              id="TextBox1" 
              autopostback=true
              runat="server"
              text="Hello World!">
            </aspSample:CustomTextBoxOnTextChanged>
            
        </form>
    </body>
</HTML>

Imports System.Web
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls
    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public NotInheritable Class CustomTextBoxOnTextChanged
        Inherits System.Web.UI.WebControls.TextBox

        Private isDirty As Boolean = False

        Protected Overrides Sub OnTextChanged(ByVal e As System.EventArgs)

            ' Call the base OnTextChanged method.
            MyBase.OnTextChanged(e)

            ' Change the dirty flag to True.
            isDirty = True
        End Sub
    End Class
End Namespace

using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomTextBoxOnTextChanged : System.Web.UI.WebControls.TextBox
  {
    private bool isDirty = false;

    protected override void OnTextChanged(System.EventArgs e)
    {
      // Call the base OnTextChanged method.
      base.OnTextChanged(e);

      // Change the dirty flag to True.
      isDirty = true;
    }
  }
}

package Samples.AspNet.JSL.Controls; 

public class CustomTextBoxOnTextChanged
    extends System.Web.UI.WebControls.TextBox
{
    private boolean isDirty = false;

    protected void OnTextChanged(System.EventArgs e)
    {
        // Call the base OnTextChanged method.
        super.OnTextChanged(e);
        // Change the dirty flag to True.
        isDirty = true;
    } //OnTextChanged
} //CustomTextBoxOnTextChanged

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

TextBox-Klasse
TextBox-Member
System.Web.UI.WebControls-Namespace
TextChanged
System.EventArgs

Weitere Ressourcen

Auslösen eines Ereignisses
Behandeln von Ereignissen
TextBox-Webserver-Steuerelement

Freigeben über