Edit

Share via

HtmlTextArea.Name Property

  • Reference

Definition

Namespace:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Gets or sets the unique identifier name for the HtmlTextArea control.

C# 
public virtual string Name { get; set; }

Property Value

String

A string that represents the value of the UniqueID property.

Examples

The following code example demonstrates how to use the Name property to select an HtmlTextArea control on a page and set its Value property.

ASP.NET (C#) 
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" >
  
  void Page_Load(Object sender, EventArgs e)
  {

    // Bind a data source to the Repeater control. 
    Repeater1.DataSource = CreateRepeaterSource();
    Repeater1.DataBind();

  }

  void Item_Bound(Object sender, RepeaterItemEventArgs e)
  {

    // The ItemDataBound event is raised when data is bound to an 
    // item in the Repeater control. Items can include the Header,
    // Footer, and so on. Use the following logic only if the item 
    // being bound is an Item or AlternatingItem.
    if (e.Item.ItemType == ListItemType.Item ||
        e.Item.ItemType == ListItemType.AlternatingItem)
    {

      // The runtime automatically generates a unique identifier 
      // for each control embedded in a list control, such as the
      // Repeater control. The Name property of the HtmlTextArea 
      // control contains this unique identifier and is commonly used to 
      // identify a specific control.

      // Retrieve the HtmlTextArea control from the RepeaterItem.
      HtmlTextArea area = (HtmlTextArea)e.Item.FindControl("TextArea1");

      // Insert a custom message for the fourth HtmlTextArea control by
      // looking for a Name property that contains the number 3.
      if (area.Name.Contains("3"))
      {

        area.Value = "Hello World";

      }

    }

  }

  DataView CreateRepeaterSource()
  {

    // Create a DataTable that contains sample data for the 
    // Repeater control.
    DataTable dt = new DataTable();
    DataRow dr;

    dt.Columns.Add(new DataColumn("Category", typeof(String)));

    // Populate the DataTable with sample values.
    for (int i = 0; i < 5; i++)
    {
      dr = dt.NewRow();

      dr[0] = "Category " + i.ToString();

      dt.Rows.Add(dr);
    }

    // Create a DataView from the DataTable.
    DataView dv = new DataView(dt);
    return dv;

  }
  
</script>

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

   <form id="form1" runat="server">
  
      <h3>HtmlTextArea Name Example</h3>

      Notice that Category 3 has custom text. <br />  
  
      <asp:Repeater id="Repeater1"
                    onitemdatabound="Item_Bound"
                    runat="server">

         <ItemTemplate>

            <h4><%# DataBinder.Eval(Container.DataItem, "Category") %></h4>

            Enter text:

            <br />

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

            <br /><br />

            <hr />

         </ItemTemplate>

      </asp:Repeater>
  
   </form>

</body>
</html>

Remarks

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

Note

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

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

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

See also