DataControlFieldCollection クラス

.NET Framework クラス ライブラリ リファレンス

DataControlFieldCollection クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

GridView、DetailsView などのデータ バインド コントロールで使用される DataControlField オブジェクトのコレクションを表します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 DataControlFieldCollection
    Inherits StateManagedCollection

Visual Basic (使用法)

Dim instance As DataControlFieldCollection

C#

public sealed class DataControlFieldCollection
 : StateManagedCollection

C++

public ref class DataControlFieldCollection
 sealed : public StateManagedCollection

J#

public final class DataControlFieldCollection
 extends StateManagedCollection

JScript

public final class DataControlFieldCollection
 extends StateManagedCollection

解説

DataControlFieldCollection クラスは、子コントロールの表示方法を指定するためにデータ バインド コントロールで使用される DataControlField オブジェクトのコレクションを表します。DataControlFieldCollection クラスは、IStateManager オブジェクトを格納するためだけに使用される抽象基本コレクション クラスである StateManagedCollection から派生します。

StateManagedCollection オブジェクトは、DataControlFieldCollection オブジェクトの動作に影響します。コレクションに動的に追加される DataControlField オブジェクトは、状態が復元されると再度追加されます。つまり、ASP.NET のほとんどのコレクション型のように、ポストバックごとではなく、一度だけフィールドを追加、削除、または変更するだけでかまいません。

(DataControlField クラスは IStateManager インターフェイスを実装します。その結果、このクラスの状態を ASP.NET ビューステートに格納できるようになります。)

DataControlFieldCollection クラスを使用して、DataControlField オブジェクトのセットをプログラムによって管理します。これらのフィールドを宣言によって定義する方がより一般的です。

DataControlFieldCollection クラスの適切なメソッドを使用して、DataControlField オブジェクトを追加、挿入、および削除できます。プログラムによってコレクションから DataControlField オブジェクトを取得するには、次のメソッドのいずれかを使用します。

• インデクサを使用し、配列表記を使ってコレクションから単一の DataControlField オブジェクトを取得します。

• GetEnumerator メソッドを使用して System.Collections.IEnumerator 実装オブジェクトを作成します。その後、このオブジェクトを使用して、コレクションから項目を取得できます。

Count プロパティは、コレクションの項目の合計数を指定します。通常は、コレクションの上限を確認するために使用されます。Add、Insert、Remove、RemoveAt の各メソッドを使用して、コレクションに対して項目の追加と削除を実行できます。

GridView コントロールまたは DetailsView コントロールを使用している場合 (AutoGenerateColumns プロパティが true の場合など)、自動的に作成された DataControlField オブジェクトは、パブリックにアクセスできるフィールド コレクションに格納されません。自動的に生成されていない DataControlField オブジェクトだけにアクセスして操作できます。

各種のデータ コントロール フィールド クラスとその使用方法について次の表に示します。

パラメータ クラス	説明
DataControlField	すべてのフィールドの抽象基本クラス。
BoundField	ASP.NET データ ソース コントロールから取得するテキストまたはデータにバインドするために使用される、データ バインド コントロール フィールド。
ButtonFieldBase	汎用的なボタン機能をカプセル化するデータ バインド コントロール フィールド。ButtonField および CheckBoxField は、このフィールドから派生します。
ButtonField	ボタンを 1 つ以上表示するデータ バインド コントロール フィールド。
CheckBoxField	CheckBox コントロールを表示するデータ バインド コントロール フィールド。
CommandField	編集、更新、削除など、行 (または列) に表示されるデータに対して実行できるアクションを表示するデータ バインド コントロール フィールド。
HyperLinkField	HyperLink コントロールを表示するデータ バインド コントロール フィールド。
ImageField	Image コントロールを表示するデータ バインド コントロール フィールド。
TemplateField	データ バインド コントロールにカスタム コンテンツを表示するデータ バインド コントロール フィールド。

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.Web.UI.StateManagedCollection
    System.Web.UI.WebControls.DataControlFieldCollection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataControlFieldCollection メンバ
System.Web.UI.WebControls 名前空間
DataControlField クラス
GridView
DetailsView