TextBox::OnTextChanged Method (EventArgs^)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Raises the TextChanged event. This allows you to handle the event directly.

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

protected:
virtual void OnTextChanged(
	EventArgs^ e
)

Parameters

e
Type: System::EventArgs^

A EventArgs that contains event information.

The TextChanged event is raised when the content of the text box changes between posts to the server.

System_CAPS_noteNote

A TextBox control must persist some values between posts to the server for this event to work correctly. Be sure that view state is enabled for this control.

Raising an event invokes the event handler through a delegate. For more information, see NIB: Raising an Event.

The OnTextChanged method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors:

When overriding OnTextChanged in a derived class, be sure to call the base class's OnTextChanged method so that registered delegates receive the event.

The following code example demonstrates how to override the OnTextChanged method so that it always marks a custom TextBox server control as having been modified.

System_CAPS_security Security Note

This example has a text box that accepts user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

No code example is currently available or this language may not be supported.
No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show: