HtmlInputControl.Name-Eigenschaft

Artikel
08/20/2007

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

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Property Name As String
'Usage
Dim instance As HtmlInputControl
Dim value As String

value = instance.Name

instance.Name = value

public virtual string Name { get; set; }

public:
virtual property String^ Name {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_Name ()

/** @property */
public void set_Name (String value)

public function get Name () : String

public function set Name (value : String)

Eigenschaftenwert

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

Hinweise

Mit der Name-Eigenschaft können Sie den eindeutigen Bezeichnernamen für ein HtmlInputControl 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 für das ordnungsgemäße Funktionieren der meisten Steuerelemente die Name-Eigenschaft denselben Wert wie die Control.UniqueID-Eigenschaft aufweisen muss.

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

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit der Name-Eigenschaft der Name des HtmlInputControl bestimmt wird, auf den geklickt wurde.

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<html>

<head>

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

<html>

<head>

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

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

HtmlInputControl-Klasse
HtmlInputControl-Member
System.Web.UI.HtmlControls-Namespace
Control.UniqueID

Freigeben über