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 programmatico univoco assegnato al HtmlForm controllo.
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 programmatico univoco assegnato al HtmlForm controllo.
Esempio
Nell'esempio di codice seguente viene illustrato come utilizzare la UniqueID proprietà per recuperare l'identificatore univoco per 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 un oggetto 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 il rendering del HtmlForm controllo viene eseguito 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à .
Annotazioni
L'attributo name non è un attributo conforme a XHTML e per impostazione predefinita non viene eseguito il rendering da ASP.NET.