Freigeben über

HtmlForm.UniqueID Eigenschaft

Definition

Namespace:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Ruft den eindeutigen programmgesteuerten Bezeichner ab, der dem HtmlForm Steuerelement zugewiesen ist.

public:
 virtual property System::String ^ UniqueID { System::String ^ get(); };
public override string UniqueID { get; }
member this.UniqueID : string
Public Overrides ReadOnly Property UniqueID As String

Eigenschaftswert

String

Der eindeutige programmgesteuerte Bezeichner, der dem HtmlForm Steuerelement zugewiesen ist.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die UniqueID Eigenschaft verwendet wird, um den eindeutigen Bezeichner für ein HtmlForm Steuerelement abzurufen.

<%@ page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="Server">
 
  void Button1_Click(object sender, System.EventArgs e)
  {
    
    // Write the form's UniqueID to the specified Label control.
    Label1.Text = "The HtmlForm control's UniqueID is "
                  + Form1.UniqueID + ".";
  }

  void Button2_Click(object sender, System.EventArgs e)
  {
    
    // Write the button's UniqueID to the specified Label control.
    Label2.Text = "This Button control's UniqueID is "
                 + Button2.UniqueID + ".";
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>

    <title>HtmlForm UniqueID Property Example</title>

</head>

<body>

    <form id="Form1"
          runat="server">
    
    <h3>HtmlForm UniqueID Property Example</h3>        
  
    <asp:button id="Button1"
                text="Get the form's UniqueID" 
                onclick="Button1_Click"
                runat="server">
    </asp:button>
    
    <asp:label id="Label1"
               runat="Server">
    </asp:label>
    
    <br />
    
    <asp:button id="Button2" 
                text="Get this button's UniqueID"
                onclick="Button2_Click"
                runat="server">
    </asp:button>

     
  
    <asp:label id="Label2"
               runat="server">
    </asp:label>
    
  </form>

</body>

</html>

<%@ page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    
  Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
  
    ' Write the form's UniqueID to the specified Label control.
    Label1.Text = "The HtmlForm control's UniqueID is " _
                  & Form1.UniqueID + "."
  End Sub
    
  Sub Button2_Click(ByVal sender As Object, ByVal e As System.EventArgs)
  
    ' Write the button's UniqueID to the specified Label control.
    Label2.Text = "This Button control's UniqueID is " _
                  & Button2.UniqueID & "."
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>

    <title>HtmlForm UniqueID Property Example</title>

</head>

<body>

    <form id="Form1"
          runat="server">
    
    <h3>HtmlForm UniqueID Property Example</h3>        
  
    <asp:button id="Button1"
                text="Get the form's UniqueID" 
                onclick="Button1_Click"
                runat="server">
    </asp:button>
    
    <asp:label id="Label1"
               runat="Server">
    </asp:label>
    
    <br />
    
    <asp:button id="Button2" 
                text="Get this button's UniqueID"
                onclick="Button2_Click"
                runat="server">
    </asp:button>

    &nbsp    ;
  
    <asp:label id="Label2"
               runat="server">
    </asp:label>
    
  </form>

</body>

</html>

Hinweise

Verwenden Sie die UniqueID Eigenschaft, um den eindeutigen programmgesteuerten Bezeichner abzurufen, der dem HtmlForm Steuerelement zugewiesen ist. Diese Eigenschaft setzt die Basisimplementierung außer Kraft, um einen Konstantenwert zurückzugeben, wenn das Steuerelement in einem INamingContaineranderen als einer Seite enthalten ist, z. B. ein benutzerdefiniertes Serversteuerelement. Wenn der Benennungscontainer eine Seite ist, wird der Wert der Eigenschaft des HtmlForm Steuerelements ID zurückgegeben.

Die UniqueID Eigenschaft und die Name Eigenschaft geben immer denselben Wert zurück. Dies ist nützlich, wenn das HtmlForm Steuerelement in einem Browser gerendert wird, für den die HtmlForm Eigenschaften und Name Eigenschaften des Steuerelements UniqueID identisch sein müssen. Um diese Eigenschaften synchron zu halten, gibt die Name Eigenschaft immer den Wert der UniqueID Eigenschaft zurück.

Hinweis

Das name Attribut ist kein XHTML-kompatibles Attribut und wird standardmäßig nicht von ASP.NET gerendert.

Gilt für:

Weitere Informationen