HtmlTextArea.Cols Property

Reference

Definition

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 property int Cols { int get(); void set(int value); };

public int Cols { get; set; }

member this.Cols : int with get, set

Public Property Cols As Integer

Property Value

Int32

The width (in characters) of the HtmlTextArea control. The default value is -1, which indicates that this property is not set.

Examples

The following code example demonstrates how to use the Cols property to control the width of the HtmlTextArea control.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void SubmitBtn_Click(Object sender, EventArgs e)
  {
    TextArea1.Cols = Convert.ToInt32(Select1.Value);
    Span1.InnerHtml = "You wrote: <br />" + TextArea1.Value;
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
   <title>HtmlTextArea Example</title>
</head>

<body>

   <form id="form1" runat="server">

      <h3>HtmlTextArea Example</h3>

      Enter your comments: <br />

      <textarea rows="2" cols="20" id="TextArea1" 
                runat="server"/>

      <br />
      Select column width: <br />

      <select id="Select1"
              runat="server">

         <option value="10" selected="selected"> 10 </option>
         <option value="20"> 20 </option>
         <option value="30"> 30 </option>
         <option value="40"> 40 </option>
         <option value="50"> 50 </option>
         <option value="60"> 60 </option>

      </select>

      <br /><br />

      <input type="submit"  
             value="Submit" 
             onserverclick="SubmitBtn_Click" 
             runat="server"/>

      <br />

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

   </form>

</body>
</html>

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Sub SubmitBtn_Click(ByVal sender As Object, ByVal e As EventArgs)
      
    TextArea1.Cols = CInt(Select1.Value)
    Span1.InnerHtml = "You wrote: <br />" + TextArea1.Value
      
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
   <title>HtmlTextArea Example</title>
</head>

<body>

   <form id="form1" runat="server">

      <h3>HtmlTextArea Example</h3>

      Enter your comments: <br />

      <textarea rows="2" cols="20" id="TextArea1" 
                runat="server"/>

      <br />

      Select column width: <br />

      <select id="Select1"
              runat="server">

         <option value="10" selected="selected"> 10 </option>
         <option value="20"> 20 </option>
         <option value="30"> 30 </option>
         <option value="40"> 40 </option>
         <option value="50"> 50 </option>
         <option value="60"> 60 </option>

      </select>

      <br /><br />

      <input type="submit"  
             value="Submit" 
             onserverclick="SubmitBtn_Click" 
             runat="server"/>

      <br />

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

   </form>

</body>
</html>

Remarks

Use the Cols property to specify or determine the width (in characters) of the HtmlTextArea 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 Rows property.

Applies to

Product	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Share via