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

定義

ClientID プロパティの値を生成するために使用されるアルゴリズムを取得または設定します。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

プロパティ値

ClientID プロパティの生成方法を示す値。A value that indicates how the ClientID property is generated. 既定値は、Inherit です。The default is Inherit.

次の例はLabelコントロールに含まれている、ListViewコントロール。The following example shows Label controls that are contained in a ListView control. ListViewコントロール、ClientIDModeプロパティに設定されてPredictableClientIDRowSuffixプロパティに設定されてProductIDします。On the ListView control, the ClientIDMode property is set to Predictable and the ClientIDRowSuffix property is set to ProductID. 3 つのレンダリングされた html 作成これspan3 に対応する要素ProductIDLabelコントロール。In the rendered HTML, this creates three span elements that correspond to three ProductIDLabel controls. ページが実行されるときに、idの属性をspan要素は次の値に設定されます。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

注釈

ASP.NET には、生成する方法の複数のアルゴリズムが用意されています、ClientIDプロパティの値。ASP.NET provides multiple algorithms for how to generate the ClientID property value. 設定して、コントロールを使用するアルゴリズムを選択したそのClientIDModeプロパティ。You select which algorithm to use for a control by setting its ClientIDMode property. アルゴリズムがで識別される、ClientIDMode次の表に記載されている列挙値。The algorithms are identified by the ClientIDMode enumeration values that are listed in the following table.

[値]Value 説明Description
AutoID ClientID 値は、それぞれの親名前付けコンテナーの ID 値とコントロールの ID 値を連結することにより生成されます。The ClientID value is generated by concatenating the ID values of each parent naming container with the ID value of the control. コントロールの複数のインスタンスが表示されるデータ バインディング シナリオでは、コントロールの ID 値の前にインクリメント値が挿入されます。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. 各セグメントはアンダースコア文字 () で区切られます。Each segment is separated by an underscore character (). このアルゴリズムは、ASP.NET 4 より前のバージョンの ASP.NET で使用されました。This algorithm was used in versions of ASP.NET earlier than ASP.NET 4.
Static ClientID 値は、ID プロパティの値に設定されます。The ClientID value is set to the value of the ID property. コントロールが名前付けコンテナーの場合、そのコントロールは、名前付けコンテナーの階層構造に含まれるすべてのコントロールに対して最上位の階層として使用されます。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 このアルゴリズムは、データ バインド コントロール内のコントロールに対して使用されます。This algorithm is used for controls that are in data-bound controls. ClientID 値は、親名前付けコンテナーの ClientID 値とコントロールの ID 値を連結することにより生成されます。The ClientID value is generated by concatenating the ClientID value of the parent naming container with the ID value of the control. コントロールが複数の行を生成するデータ バインド コントロールである場合は、ClientIDRowSuffix プロパティで指定されたデータ フィールドの値が末尾に追加されます。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. GridView コントロールの場合は、複数のデータ フィールドを指定できます。For the GridView control, multiple data fields can be specified. 場合、ClientIDRowSuffixプロパティが空白で連番がデータ フィールドの値ではなく最後に追加します。If the ClientIDRowSuffix property is blank, a sequential number is added at the end instead of a data-field value. この番号は 0 から始まるし、行ごとに 1 ずつインクリメントされます。This number begins at zero and is incremented by 1 for each row. 各セグメントはアンダースコア文字 () で区切られます。Each segment is separated by an underscore character ().
Inherit コントロールは、ClientIDMode コントロールの NamingContainer 設定を継承します。The control inherits the ClientIDMode setting of its NamingContainer control.

既定値ClientIDModeページはPredictableします。The default value of ClientIDMode for a page is Predictable. 既定値ClientIDModeコントロールはInheritします。The default value of ClientIDMode for a control is Inherit. コントロールの既定値はためInheritモードは既定の生成、Predictableします。Because the default for controls is Inherit, the default generation mode is Predictable. (ただし、Visual Studio を使用して、以前のバージョンから Web プロジェクトを ASP.NET 4 に変換する場合は、Visual Studio に自動的にサイトの既定値を設定AutoIDWeb.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.)

詳細については、ASP.NET Web サーバー コントロールの識別に関する記事をご覧ください。For more information, see ASP.NET Web Server Control Identification.

適用対象

こちらもご覧ください