ClientIDMode ClientIDMode ClientIDMode ClientIDMode Enum

Definition

Gibt an, wie ASP.NET die ClientID für ein Steuerelement generiert, auf das im Clientskript zugegriffen werden kannSpecifies how ASP.NET generates the ClientID for a control that can be accessed in client script.

public enum class ClientIDMode
public enum ClientIDMode
type ClientIDMode = 
Public Enum ClientIDMode
Vererbung

Felder

AutoID AutoID AutoID AutoID 1

Der ClientID-Wert wird generiert, indem die ID-Werte der einzelnen übergeordneten Benennungscontainer mit dem ID-Wert des Steuerelements verkettet werdenThe ClientID value is generated by concatenating the ID values of each parent naming container with the ID value of the control. In Datenbindungsszenarios, in denen mehrere Instanzen eines Steuerelements gerendert werden, wird vor dem ID-Wert des Steuerelements ein inkrementierender Wert eingefügt.In data-binding scenarios where multiple instances of a control are rendered, an incrementing value is inserted in front of the control's ID value. Die einzelnen Segmente werden durch einen Unterstrich () getrennt.Each segment is separated by an underscore character (). Dieser Algorithmus ist der einzige, der in niedrigeren Versionen als ASP.NET 4 verfügbar war.This algorithm is the only one that was available in versions of ASP.NET earlier than ASP.NET 4.

Inherit Inherit Inherit Inherit 0

Das Steuerelement erbt die ClientIDMode-Einstellung seines NamingContainer-Steuerelements.The control inherits the ClientIDMode setting of its NamingContainer control.

Predictable Predictable Predictable Predictable 2

Dieser Algorithmus wird für Steuerelemente in datengebundenen Steuerelementen verwendet.This algorithm is used for controls that are in data-bound controls. Der ClientID-Wert wird generiert, indem der ClientID-Wert des übergeordneten Benennungscontainers mit dem ID-Wert des Steuerelements verkettet wird.The ClientID value is generated by concatenating the ClientID value of the parent naming container with the ID value of the control. Wenn es sich bei dem Steuerelement um ein datengebundenes Steuerelement handelt, das mehrere Zeilen generiert, wird der Wert des in der ClientIDRowSuffix-Eigenschaft angegebenen Datenfelds am Ende hinzugefügt.If the control is a data-bound control that generates multiple rows, the value of the data field specified in the ClientIDRowSuffix property is added at the end. Für das GridView-Steuerelement können mehrere Datenfelder angegeben werden.For the GridView control, multiple data fields can be specified. Wenn die ClientIDRowSuffix-Eigenschaft leer ist, wird am Ende anstelle eines Datenfeldwerts eine laufende Nummer hinzugefügt.If the ClientIDRowSuffix property is blank, a sequential number is added at the end instead of a data field value. Die einzelnen Segmente werden durch einen Unterstrich () getrennt.Each segment is separated by an underscore character ().

Static Static Static Static 3

Der ClientID-Wert wird auf den Wert der ID-Eigenschaft festgelegt.The ClientID value is set to the value of the ID property. Wenn es sich bei dem Steuerelement um einen Benennungscontainer handelt, ist das Steuerelement für alle enthaltenen Steuerelemente das oberste Element in der Hierarchie von Benennungscontainern.If the control is a naming container, the control is used as the top of the hierarchy of naming containers for any controls that it contains.

Beispiele

Das folgende Beispiel zeigt Label in enthaltenen Steuerelemente eine ListView Steuerelement.The following example shows Label controls that are contained in a ListView control. Auf der ListView -Steuerelement, das ClientIDMode -Eigenschaftensatz auf vorhersagbar und die ClientIDRowSuffix -Eigenschaftensatz auf ProductID.On the ListView control, the ClientIDMode property is set to Predictable and the ClientIDRowSuffix property is set to ProductID. Aus dem Clientskript, erreichen Sie eine bestimmte Instanz einer Label basierend auf den ProductID Wert der Instanz, die Sie zugreifen möchten.From client script, you can access a particular instance of a Label based on the ProductID value of the instance that you are trying to access.

In diesem Beispiel wird HTML erstellt, wobei mit drei ProductIDLabel Steuerelemente.This example creates HTML with three ProductIDLabel controls. Wenn die Seite ausgeführt wird, werden die IDs für die Steuerelemente Folgendes:When the page runs, the IDs for the controls will be the following:

  • ListView1_ProductIDLabel_1

  • ListView1_ProductIDLabel_34

  • ListView1_ProductIDLabel_43

Weitere Informationen finden Sie unter ASP.NET Web FormsFor more information, see ASP.NET Web Server Control Identification

Hinweise

Sie verwenden die ClientIDMode Enumeration, die beim Festlegen der ClientIDMode Eigenschaft für ein Steuerelement.You use the ClientIDMode enumeration when you set the ClientIDMode property for a control. Der Wert, den Sie zum Zuweisen der ClientIDMode Eigenschaft bestimmt, wie die ClientID -Eigenschaft generiert wird.The value that you assign to the ClientIDMode property determines how the ClientID property is generated. Der Wert des der ClientID Eigenschaft als gerendert wird die id Attribut im Markup, und es ist der Wert, mit denen Sie das Steuerelement aus dem Clientskript zugreifen.The value of the ClientID property is rendered as the id attribute in markup, and it is the value that you use to access the control from client script. Der Wert, den Sie zuweisen der ClientIDMode Eigenschaft hat keine Auswirkungen auf die ID Eigenschaft des Serversteuerelements, nur die id -Attribut des entsprechenden HTML-Elements.The value that you assign to the ClientIDMode property does not affect the ID property of the server control, only the id attribute of the corresponding HTML element.

Der Standardwert von ClientIDMode für eine Seite vorhersagbar ist.The default value of ClientIDMode for a page is Predictable. Der Standardwert von ClientIDMode für ein Steuerelement erben ist.The default value of ClientIDMode for a control is Inherit.

Da der Standard für Steuerelemente erben, ist der Standardmodus für die Generation vorhersagbar.Because the default for controls is Inherit, the default generation mode is Predictable. (Allerdings, wenn Sie Visual Studio verwenden, um ein Webprojekt in ASP.NET 4 von einer früheren Version zu konvertieren, stellt Visual Studio automatisch der Standardwert der Standort auf "AutoID" in der Datei "Web.config".)(However, if you use Visual Studio to convert a Web project to ASP.NET 4 from an earlier version, Visual Studio automatically sets the site default to AutoID in the Web.config file.)

Sie können festlegen, die ClientIDMode Wert für alle Seiten auf einer Website durch Festlegen der Seiten Element in der Datei Web.config der Site.You can set the ClientIDMode value for all pages in a Web site by setting the pages element in the site's Web.config file. Sie können festlegen, die ClientIDMode Wert für eine Seite in der @ Page Richtlinie.You can set the ClientIDMode value for a page in the @ Page directive.

Weitere Informationen finden Sie unter Steuerelementidentifikation in Web Forms.For more information, see ASP.NET Web Server Control Identification.

Gilt für:

Siehe auch