HtmlInputControl.Name Propriedade

Referência

Definição

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define o nome de identificador exclusivo para o controle 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 da propriedade

String

Uma cadeia de caracteres que representa o valor da UniqueID propriedade .

Exemplos

O exemplo de código a seguir demonstra como usar a Name propriedade para determinar o nome do HtmlInputControl que foi clicado.


<%@ 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>

Comentários

Use a Name propriedade para determinar o nome do identificador exclusivo para um HtmlInputControl. Nessa implementação, o get acessador retorna o valor da Control.UniqueID propriedade . No entanto, o set acessador não atribui um valor a essa propriedade.

Observação

O set acessador não atribui um valor a essa propriedade porque a Name propriedade deve ter o mesmo valor que a propriedade para que a Control.UniqueID maioria dos controles funcione corretamente.

Classes que herdam da HtmlInputControl classe podem substituir essa implementação, se necessário.

Aplica-se a

Confira também

UniqueID

Partilhar via