HtmlInputControl.Name Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un nombre de identificador único para el control HtmlInputControl.
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
Valor de propiedad
Cadena que representa el valor de la propiedad UniqueID.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la Name propiedad para determinar el nombre del objeto en el HtmlInputControl que se hizo clic.
<%@ 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>
Comentarios
Use la Name propiedad para determinar el nombre de identificador único de .HtmlInputControl En esta implementación, el get
descriptor de acceso devuelve el valor de la Control.UniqueID propiedad . Sin embargo, el set
descriptor de acceso no asigna un valor a esta propiedad.
Nota:
El set
descriptor de acceso no asigna un valor a esta propiedad porque la Name propiedad debe tener el mismo valor que la propiedad para que la Control.UniqueID mayoría de los controles funcionen correctamente.
Las clases que heredan de la HtmlInputControl clase pueden invalidar esta implementación, si es necesario.