Skip to main content
.NET Framework Class Library
HtmlInputControl..::.Name Property

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

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in System.Web.dll)
Syntax
Public Overridable Property Name As String
	Get
	Set
public virtual string Name { get; set; }
public:
virtual property String^ Name {
	String^ get ();
	void set (String^ value);
}
abstract Name : string with get, set
override Name : string with get, set
<asp:HtmlInputControl Name="String" />

Property Value

Type: System..::.String
A string that represents the value of the Control..::.UniqueID property.
Remarks

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

NoteNote

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 most controls to work properly.

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

Examples

The following code example demonstrates how to use the Name property to determine the name of the HtmlInputControl that was clicked.



<%@ Page Language="VB" 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">
<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
    <title> HtmlInputControl Name Example </title>
<script runat="server">

      Sub Page_Load(sender As Object, e As EventArgs)

         ' Create a data source.
         Dim dt As DataTable = New DataTable()
         Dim dr As DataRow

         dt.Columns.Add(new DataColumn("Value", GetType(String)))

         Dim i As Integer   

         For i = 0 to 2

            dr = dt.NewRow()

            dr(0) = "Item " + i.ToString()

            dt.Rows.Add(dr)

         Next i

         ' Bind the data source to the Repeater control.
         Repeater1.DataSource = New DataView(dt)
         Repeater1.DataBind()

      End Sub

      Sub AddButton_Click(sender As Object, e As EventArgs)

         Message.Text = "The name of the HtmlInputControl clicked is " & _ 
                        CType(sender, HtmlInputControl).Name

      End Sub

   </script>

</head>

<body>

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

      <h3> HtmlInputControl Name Example </h3>

      <asp:Repeater id="Repeater1"
           runat="server">

         <ItemTemplate>

            <input type="submit"
                   name="AddButton"
                   value='<%# DataBinder.Eval(Container.DataItem, "Value") %>'
                   onserverclick="AddButton_Click"
                   runat="server"/>

         </ItemTemplate>


      </asp:Repeater>

      <br /><br />

      <asp:Label id="Message" runat="server"/>

   </form>

</body>

</html>




<%@ 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">
<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
    <title> HtmlInputControl Name Example </title>
<script runat="server">

      void Page_Load(Object sender, EventArgs e)
      {

         // Create a data source.
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("Value", typeof(string)));

         for (int i = 0; i < 3; i++) 
         {
            dr = dt.NewRow();

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

            dt.Rows.Add(dr);
         }

         // Bind the data source to the Repeater control.
         Repeater1.DataSource = new DataView(dt);
         Repeater1.DataBind();

      }

      void AddButton_Click(Object sender, EventArgs e)
      {

         Message.Text = "The name of the HtmlInputControl clicked is " + 
                        ((HtmlInputControl)sender).Name;

      }

   </script>

</head>

<body>

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

      <h3> HtmlInputControl Name Example </h3>

      <asp:Repeater id="Repeater1"
           runat="server">

         <ItemTemplate>

            <input type="submit"
                   name="AddButton"
                   value='<%# DataBinder.Eval(Container.DataItem, "Value") %>'
                   onserverclick="AddButton_Click"
                   runat="server"/>

         </ItemTemplate>


      </asp:Repeater>

      <br /><br />

      <asp:Label id="Message" runat="server"/>

   </form>

</body>

</html>


Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0
Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.