Control.ClientIDMode Control.ClientIDMode Control.ClientIDMode Control.ClientIDMode Property

Definition

Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest.Gets or sets the algorithm that is used to generate the value of the ClientID property.

public:
 virtual property System::Web::UI::ClientIDMode ClientIDMode { System::Web::UI::ClientIDMode get(); void set(System::Web::UI::ClientIDMode value); };
[System.Web.UI.Themeable(false)]
public virtual System.Web.UI.ClientIDMode ClientIDMode { get; set; }
member this.ClientIDMode : System.Web.UI.ClientIDMode with get, set
Public Overridable Property ClientIDMode As ClientIDMode

Eigenschaftswert

Ein Wert, der angibt, wie die ClientID-Eigenschaft generiert wird.A value that indicates how the ClientID property is generated. Die Standardeinstellung ist Inherit.The default is Inherit.

Beispiele

Das folgende Beispiel zeigt Label Steuerelemente, die in einem ListView -Steuerelement enthalten sind.The following example shows Label controls that are contained in a ListView control. Auf dem ListView Predictable -Steuerelement ClientIDMode wird die-Eigenschaft auf fest ClientIDRowSuffix gelegt, und die ProductID-Eigenschaft ist auf festgelegt.On the ListView control, the ClientIDMode property is set to Predictable and the ClientIDRowSuffix property is set to ProductID. Im gerenderten HTML werden dadurch drei span Elemente erstellt, die drei ProductIDLabel -Steuerelementen entsprechen.In the rendered HTML, this creates three span elements that correspond to three ProductIDLabel controls. Wenn die Seite ausgeführt wird, id werden die Attribute span für die Elemente auf die folgenden Werte festgelegt:When the page runs, the id attributes for the span elements are set to the following values:

  • ListView1_ProductIDLabel_1

  • ListView1_ProductIDLabel_34

  • ListView1_ProductIDLabel_43

Hinweise

ASP.net bietet mehrere Algorithmen zum Generieren des ClientID Eigenschafts Werts.ASP.NET provides multiple algorithms for how to generate the ClientID property value. Durch Festlegen ClientIDMode der-Eigenschaft wählen Sie den Algorithmus aus, der für ein Steuerelement verwendet werden soll.You select which algorithm to use for a control by setting its ClientIDMode property. Die Algorithmen werden durch die ClientIDMode in der folgenden Tabelle aufgeführten Enumerationswerte identifiziert.The algorithms are identified by the ClientIDMode enumeration values that are listed in the following table.

WertValue BeschreibungDescription
AutoID 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 wurde in früheren Versionen von ASP.net als ASP.NET 4 verwendet.This algorithm was used in versions of ASP.NET earlier than ASP.NET 4.
Static 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.
Predictable 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 Daten Feldwerts eine sequenzielle Zahl hinzugefügt.If the ClientIDRowSuffix property is blank, a sequential number is added at the end instead of a data-field value. Diese Zahl beginnt bei Null und wird für jede Zeile um 1 erhöht.This number begins at zero and is incremented by 1 for each row. Die einzelnen Segmente werden durch einen Unterstrich () getrennt.Each segment is separated by an underscore character ().
Inherit Das Steuerelement erbt die ClientIDMode-Einstellung seines NamingContainer-Steuerelements.The control inherits the ClientIDMode setting of its NamingContainer control.

Der Standardwert ClientIDMode für eine Seite ist Predictable.The default value of ClientIDMode for a page is Predictable. Der Standardwert ClientIDMode für ein-Steuerelement Inheritist.The default value of ClientIDMode for a control is Inherit. Da der Standardwert für- InheritSteuerelemente ist, ist Predictableder Standard Generierungs Modus.Because the default for controls is Inherit, the default generation mode is Predictable. (Wenn Sie jedoch Visual Studio verwenden, um ein Webprojekt aus einer früheren Version in ASP.NET 4 zu konvertieren, legt Visual Studio die Website standardmäßig AutoID in der Datei "Web. config" auf den Standardwert fest.)(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.)

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

Gilt für:

Siehe auch