HtmlInputControl.Name Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den eindeutigen Bezeichnernamen für das HtmlInputControl-Steuerelement ab oder legt diesen fest.

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

Eigenschaftswert

String

Eine Zeichenfolge, die den Wert der UniqueID-Eigenschaft darstellt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Name -Eigenschaft verwendet wird, um den Namen der zu bestimmen, auf die HtmlInputControl geklickt wurde.


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

Hinweise

Verwenden Sie die Name -Eigenschaft, um den eindeutigen Bezeichnernamen für einen HtmlInputControlzu bestimmen. In dieser Implementierung gibt der get Accessor den Wert der Control.UniqueID -Eigenschaft zurück. Der set Accessor weist dieser Eigenschaft jedoch keinen Wert zu.

Hinweis

Der set Accessor weist dieser Eigenschaft keinen Wert zu, da die Name Eigenschaft den gleichen Wert wie die -Eigenschaft haben muss, damit die Control.UniqueID meisten Steuerelemente ordnungsgemäß funktionieren.

Klassen, die von der HtmlInputControl -Klasse erben, können diese Implementierung bei Bedarf überschreiben.

Gilt für:

Weitere Informationen

UniqueID

Freigeben über