HtmlForm.UniqueID Proprietà

Definizione

Ottiene l'identificatore univoco a livello di codice assegnato al controllo 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

Valore della proprietà

Identificatore univoco a livello di codice assegnato al controllo HtmlForm.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la UniqueID proprietà per recuperare l'identificatore univoco di un HtmlForm controllo.

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

Commenti

Utilizzare la UniqueID proprietà per ottenere l'identificatore programmatico univoco assegnato al HtmlForm controllo. Questa proprietà esegue l'override dell'implementazione di base per restituire un valore costante quando il controllo è contenuto in un INamingContaineroggetto implementato da diverso da una pagina, ad esempio un controllo server personalizzato. Se il contenitore di denominazione è una pagina, viene restituito il valore della HtmlForm proprietà del ID controllo.

La UniqueID proprietà e la Name proprietà restituiscono sempre lo stesso valore. Ciò è utile quando viene eseguito il rendering del HtmlForm controllo in un browser che richiede che le HtmlForm proprietà e Name del UniqueID controllo siano uguali. Per mantenere sincronizzate queste proprietà, la Name proprietà restituisce sempre il valore della UniqueID proprietà .

Nota

L'attributo name non è un attributo conforme a XHTML e per impostazione predefinita non viene eseguito il rendering da ASP.NET.

Si applica a

Vedi anche