HtmlForm.UniqueID 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 programmgesteuerten Bezeichner ab, der dem HtmlForm-Steuerelement zugewiesen wurde.

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 zum Abrufen des eindeutigen Bezeichners für ein HtmlForm Steuerelement verwendet wird.

<%@ 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 überschreibt die Basisimplementierung, um einen konstanten Wert zurückzugeben, wenn das Steuerelement in einem INamingContaineranderen -implementierten Objekt als einer Seite enthalten ist, z. B. einem benutzerdefinierten Serversteuerelement. Wenn der Benennungscontainer eine Seite ist, wird der Wert der HtmlForm -Eigenschaft des Steuerelements ID zurückgegeben.

Die UniqueID Eigenschaft und die Name Eigenschaft geben immer den gleichen Wert zurück. Dies ist nützlich, wenn das HtmlForm Steuerelement in einem Browser gerendert wird, der erfordert, dass die HtmlForm Eigenschaften des Steuerelements UniqueID und Name identisch sind. Damit diese Eigenschaften synchronisiert bleiben, 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:

Freigeben über