HtmlForm.UniqueID Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Obtient l'ID programmatique unique assigné au contrôle HtmlForm.

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

Valeur de propriété

String

ID programmatique unique assigné au contrôle HtmlForm.

Exemples

L’exemple de code suivant montre comment utiliser la UniqueID propriété pour récupérer l’identificateur unique d’un HtmlForm contrôle.

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

Remarques

Utilisez la UniqueID propriété pour obtenir l’identificateur programmatique unique affecté au HtmlForm contrôle. Cette propriété remplace l’implémentation de base pour renvoyer une valeur constante lorsque le contrôle est contenu dans un INamingContainerobjet implémenté autre qu’une page, tel qu’un contrôle serveur personnalisé. Si le conteneur de noms est une page, la valeur de la HtmlForm propriété du ID contrôle est retournée.

La UniqueID propriété et la Name propriété retournent toujours la même valeur. Cela est utile lorsque le HtmlForm contrôle est rendu sur un navigateur qui nécessite que les HtmlForm propriétés du UniqueID contrôle et Name soient identiques. Pour que ces propriétés restent synchronisées, la Name propriété retourne toujours la valeur de la UniqueID propriété.

Notes

L’attribut name n’est pas un attribut compatible XHTML et, par défaut, n’est pas rendu par ASP.NET.

S’applique à

Voir aussi