System.Web 1.0.5000.0 2.0.0.0 Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details. System.Web.UI.HtmlControls.HtmlContainerControl System.Web.UI.IPostBackDataHandler System.Web.UI.SupportsEventValidation System.Web.UI.ValidationProperty("Value") System.ComponentModel.DefaultEvent("ServerChange")

The control corresponds to the <textarea> HTML element that allows you to create a multiline text box on a Web page. Use this control to programmatically manipulate a <textarea> HTML element.

This class allows you to control the height and width of a multiline text box by setting the and properties, respectively. You also can assign a name to the control by setting the property. To determine or specify the text in the text box, use the property.

The class provides a event that allows you to perform a custom set of instructions every time the value of the text box changes between posts to the server. This event is commonly used for data validation.

If you want to create a single-line text box, use the control.

For a list of initial property values for an instance of , see the constructor.

This control can be used to display user input, which might include malicious client script. Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. ASP.NET provides an input request validation feature to block script and HTML in user input. Validation server controls are also provided to assess user input. For more information, see [<topic://cpconASPNETSyntaxForValidationControls>].

Allows programmatic access to the <textarea> HTML element on the server.

- Constructor

  Use this constructor to create and initialize a new instance of the class.

  The following table shows initial property values for an instance of .

  Property

  Initial Value

  The "textarea" literal string.

  Initializes a new instance of the class.

  1.0.5000.0
  2.0.0.0
- Method
  System.Void ``

  The method adds an object to the control's if the object is of the type or ; otherwise, an is thrown.

  The method is primarily used by control developers extending the functionality of the control.

  Notifies the control that an object was parsed and adds the object to the control's object.

  An that represents the parsed element. 1.0.5000.0 2.0.0.0
- Property
  System.Int32 To be added: an object of type 'int'

  Use the property to specify or determine the width (in characters) of the control. If you enter text that is longer than the width of the text box, the text automatically continues on the next line of the control.

  To control the height of the control, set the property.

  Gets or sets the width (in characters) of the control.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")
- Method
  2.0.0.0
  System.Boolean `` ``

  The method checks whether the postback value of the control is different from its previous value, and if so, returns true.

  The method is used primarily by control developers extending the functionality of the control.

  Processes the postback data for the control.

  true if the control's state has changed as a result of the postback; otherwise, false.

  The key identifier for the control. The collection of all incoming name values.
- Property
  System.String To be added: an object of type 'string'

  Use the property to determine the unique identifier name for the control. In this implementation of the property, the get accessor returns the value of the property. However, the set accessor does not assign a value to this property.

  The set accessor does not assign a value to this property because the property must have the same value as the property for the control to work properly.

  Classes that inherit from the class may override this implementation, if necessary.

  Gets or sets the unique identifier name for the control.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")
- Method
  System.Void ``

  The method notifies the control to perform any necessary steps prior to saving the view state and rendering content.

  The method is used primarily by control developers extending the functionality of the control.

  Raises the event.

  An object that contains the event data. 1.0.5000.0 2.0.0.0
- Method
  System.Void ``

  The event is raised when the content of the control changes between posts to the server.

  This event is only raised when the user initiates a post to the server, such as by clicking a submit button. This event does not cause a post to the server to occur.

  The control must have viewstate enabled for the event to work correctly.

  This event is commonly used to perform data validation on the control when the user updates the text in the control.

  Raising an event invokes the event handler through a delegate. For more information, see [<topic://cpconProvidingEventFunctionality>].

  The 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.

  Raises the event of the control. This allows you to provide a custom handler for the event.

  A that contains the event data. 1.0.5000.0 2.0.0.0
- Method
  2.0.0.0
  System.Void

  The method is used primarily by control developers extending the functionality of the control.

  Calls the method to signal the control that the state of the control has changed.

- Method
  System.Void ``

  The method renders the attribute of the control directly to ensure that it has the same value as the property. After rendering the attribute, the method calls the base class's method.

  The method is used primarily by control developers extending the functionality of the control.

  Renders the control's attributes to the specified object.

  The that receives the rendered content. 1.0.5000.0 2.0.0.0
- Property
  System.Int32 To be added: an object of type 'int'

  Use the property to specify or determine the height (in characters) of the control. If you enter text that takes up more lines than the height specified, scroll bars are enabled.

  To control the width of the control, set the property.

  Gets or sets the height (in characters) of the control.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")
- Event
  System.EventHandler

  The event is raised when the content of the control changes between posts to the server. This event is commonly used to perform data validation on the text box.

  This event is only raised when the user initiates a post to the server, such as clicking a submit button. This event does not cause a post to the server to occur.

  The control must have viewstate enabled for the event to work correctly.

  For more information about handling events, see Consuming Events.

  Occurs when the content of the control changes between posts to the server.

  1.0.5000.0
  2.0.0.0
- Method
  1.0.5000.0
  2.0.0.0
  System.Boolean `` ``

  This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.

  For a description of this member, see .

  true if the control's state has changed as a result of postback; otherwise, false.

  The key identifier for the control. The collection of all incoming name values.
- Method
  1.0.5000.0
  2.0.0.0
  System.Void

  This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface.

  For a description of this member, see .

- Property
  System.String To be added: an object of type 'string'

  Use the property to programmatically control the text entered in the control. This property is commonly used to retrieve the text entered in the text box, but you can also use it to specify the text to display in the control. This is useful if you want to provide a default value or display a message in the control.

  This control can be used to display user input, which might include malicious client script. Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. ASP.NET provides an input request validation feature to block script and HTML in user input. Validation server controls are also provided to assess user input. For more information, see [<topic://cpconASPNETSyntaxForValidationControls>].

  Gets or sets the text entered in the control.

  1.0.5000.0
  2.0.0.0
  System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)
  System.ComponentModel.DefaultValue("")