IDataKeysControl インターフェイス


ASP.NET がデータ バインド コントロールのクライアント ID を作成する方法を指定するプロパティを定義します。Defines properties that specify how ASP.NET creates client IDs for a data-bound control.

public interface class IDataKeysControl
public interface IDataKeysControl
type IDataKeysControl = interface
Public Interface IDataKeysControl


インターフェイスは、 IDataKeysControl クライアント ID の作成方法を指定できるように、データバインドコントロールが実装する2つのプロパティを定義します。The IDataKeysControl interface defines two properties that data-bound controls implement to let you specify how a client ID is created. コントロールの複数のインスタンスを表示するデータバインドコントロールでは、コントロールのインスタンスごとに ID を作成する必要があります。A data-bound control that displays multiple instances of a control must create an ID for each instance of the control. クライアントスクリプトからコントロールにアクセスできるようにするには、その ID が一意である必要があります。That ID must be unique in order to enable access to the control from client script.

ClientIDRowSuffixプロパティを使用すると、プロパティに対して生成された値に値が含まれるデータフィールドの名前または名前を指定でき ClientID ます。The ClientIDRowSuffix property lets you specify the name or names of data fields whose values are included in the generated value for the ClientID property. これらの値は、コントロールがページ上に表示される順序などの任意の値ではなく、意味のあるデータ値に対応するように、コントロールの各インスタンスを一意に識別するために使用されます。These values are used to uniquely identify each instance of the control in a way that corresponds to a meaningful data value, instead of to an arbitrary value such as the order in which the controls are rendered on the page. たとえば、製品データテーブルのレコードを表示する場合は、プロパティにを割り当てることができ ProductID ClientIDRowSuffix ます。For example, when you display records from a products data table, you can assign ProductID to the ClientIDRowSuffix property. その場合は、データバインドコントロールの各インスタンスを、フィールドの値によって識別でき ProductID ます。In that case, each instance of the data-bound control can be identified by the value from the ProductID field.



ASP.NET が ClientID アルゴリズムを使用して Predictable 値を生成するときに、データ バインド コントロールの各インスタンスを一意に識別するために使用される値を持つデータ フィールドの名前を取得します。Gets the names of the data fields whose values are used to uniquely identify each instance of a data-bound control when ASP.NET generates the ClientID value by using the Predictable algorithm.


ASP.NET が ClientID 値を生成するときに、データ バインド コントロールの各インスタンスを一意に識別するために使用されるデータ値のコレクションを取得します。Gets a collection of the data values that are used to uniquely identify each instance of a data-bound control when ASP.NET generates the ClientID value.