HtmlForm.UniqueID Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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>
  ;
<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.