Control.ClientID-Eigenschaft
Ruft den von ASP.NET generierten Bezeichner des Serversteuerelements ab.
Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Overridable ReadOnly Property ClientID As String
'Usage
Dim instance As Control
Dim value As String
value = instance.ClientID
public virtual string ClientID { get; }
public:
virtual property String^ ClientID {
String^ get ();
}
/** @property */
public String get_ClientID ()
public function get ClientID () : String
Eigenschaftenwert
Der von ASP.NET generierte Bezeichner des Serversteuerelements.
Hinweise
Manchmal ist es nicht möglich, einem Steuerelement einen eindeutigen Namen zuzuweisen. Wenn z. B. ein Repeater-Steuerelement in einer seiner Vorlagen ein Label-Steuerelement enthält, wird eine Instanz dieses Label-Steuerelements für jedes Element im Repeater-Steuerelement wiedergegeben. Um Namenskonflikte bei der Wiedergabe mehrerer Instanzen eines Steuerelements zu vermeiden, generiert ASP.NET automatisch einen eindeutigen ClientID-Wert für jedes Serversteuerelement auf einer Seite. Der ClientID-Wert wird generiert, indem der ID-Wert des Steuerelements und der UniqueID-Wert des übergeordneten Steuerelements verkettet werden. Wenn der ID-Wert des Steuerelements nicht angegeben ist, wird ein automatisch generierter Wert verwendet. Die einzelnen Teile der generierten ID werden durch einen Unterstrich (_) getrennt.
Hinweis
Der für ein Steuerelement generierte ClientID-Wert ist identisch mit dem UniqueID-Wert, außer dass die ID-Werte durch einen Unterstrich und nicht durch das in der IdSeparator-Eigenschaft angegebene Zeichen abgegrenzt sind. Die IdSeparator-Eigenschaft ist standardmäßig auf einen Doppelpunkt (:) festgelegt. Da der ClientID-Wert keine Doppelpunkte enthält, kann er in ECMAScript verwendet werden, da ECMAScript keine IDs mit Doppelpunkten unterstützt.
Der ClientID-Wert wird häufig für den programmgesteuerten Zugriff auf das HTML-Element verwendet, das für ein Steuerelement in clientseitigem Skript wiedergegeben wird. Weitere Informationen finden Sie unter Clientskript in ASP.NET-Webseiten.
Beispiel
Im folgenden Beispiel wird das ControlCollection-Objekt für eine Seite durchlaufen und für jedes auf der Seite enthaltene Steuerelement die ClientID-Eigenschaft angezeigt.
Sub Page_Load(sender As Object, e As EventArgs)
Response.Write("<h4>Control_ClientID Sample</h4>")
' Get the list of all controls.
Dim myEnumerator As IEnumerator = Controls.GetEnumerator()
Response.Write("<br>Enumerating Controls Collection<br>")
While myEnumerator.MoveNext()
Dim myControl As Control = CType(myEnumerator.Current, Control)
' Display the ClientID property.
Response.Write("<br>The ClientID property of Control : " & myControl.ClientID)
End While
End Sub
void Page_Load(object sender,EventArgs e)
{
Response.Write("<h4>Control_ClientID Sample</h4>");
// Get the list of all controls.
IEnumerator myEnumerator = Controls.GetEnumerator();
Response.Write("<br>Enumerating Controls Collection<br>");
while(myEnumerator.MoveNext())
{
Control myControl = (Control) myEnumerator.Current;
// Display the ClientID property
Response.Write("<br>The ClientID property of Control : " + myControl.ClientID);
}
}
void Page_Load(Object sender, EventArgs e)
{
get_Response().Write("<h4>Control_ClientID Sample</h4>");
// Get the list of all controls.
IEnumerator myEnumerator = get_Controls().GetEnumerator();
get_Response().Write("<br>Enumerating Controls Collection<br>");
while(myEnumerator.MoveNext()) {
Control myControl = (Control)(myEnumerator.get_Current());
// Display the ClientID property
get_Response().Write("<br>The ClientID property of Control : "
+ myControl.get_ClientID());
}
} //Page_Load
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
Control-Klasse
Control-Member
System.Web.UI-Namespace
NamingContainer
ID
INamingContainer