HtmlInputControl.Name Property
Definition
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 unique identifier name for the HtmlInputControl control.
public:
virtual property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };
public virtual string Name { get; set; }
member this.Name : string with get, set
Public Overridable Property Name As String
Property Value
A string that represents the value of the UniqueID property.
Examples
The following code example demonstrates how to use the Name property to determine the name of the HtmlInputControl that was clicked.
<%@ 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>
<%@ 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>
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.
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 most controls to work properly.
Classes that inherit from the HtmlInputControl class can override this implementation, if necessary.