BaseDataList クラス

[アーティクル]
03/28/2008

DataList 、 DataGrid などのデータリストコントロールの抽象基本クラスとして機能します。このクラスには、すべてのデータリストコントロールに共通のメソッドとプロパティが用意されています。

この型のすべてのメンバの一覧については、BaseDataList メンバを参照してください。

System.Object
   System.Web.UI.Control
      System.Web.UI.WebControls.WebControl
         System.Web.UI.WebControls.BaseDataList
            System.Web.UI.WebControls.DataGrid
            System.Web.UI.WebControls.DataList

MustInherit Public Class BaseDataList
   Inherits WebControl
[C#]
public abstract class BaseDataList : WebControl
[C++]
public __gc __abstract class BaseDataList : public WebControl
[JScript]
public abstract class BaseDataList extends WebControl

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

BaseDataList クラスは、 DataList 、 DataGrid などのデータリストコントロールすべてに共通の機能を提供します。データリストコントロールは、 System.Data.DataView などのデータソースのレコードを表示するために使用します。各データリストコントロールには、固有の表示スタイルと機能を設定できます。 BaseDataList クラスは抽象クラスであるため、このクラスのインスタンスは直接作成されません。代わりに、データリストコントロールは、すべてのデータリストコントロールに共通のメソッドとプロパティをこのクラスから継承します。

データリストコントロールの外観を制御するには、このクラスの特定のプロパティを設定します。データリストコントロールのセル間の間隔を制御するには、 CellSpacing プロパティを設定します。セルの内容とセルの境界線の間の間隔を制御するには、 CellPadding プロパティを設定します。データリストコントロールの各セル間に境界線を表示するには、 GridLines プロパティを設定します。データリストコントロールのセルの内容の水平方向の配置を制御するには、 HorizontalAlign プロパティを設定します。

BaseDataList クラスには、データリストコントロールにデータソースを連結するためのメソッドとプロパティが用意されています。 DataSource プロパティを使用して、連結先のデータソースを指定します。

メモこのデータソースは、 BaseDataList クラスから派生したコントロールに連結する System.Collections.IEnumerable インターフェイス (System.Data.DataView 、 System.Collections.ArrayList 、 System.Collections.Hashtable など) を実装するオブジェクトである必要があります。

データソースに格納されているデータのソースが複数の場合は、 DataMember プロパティを使用して、コントロールに連結する特定のソースを指定します。たとえば複数のテーブルを持つ System.Data.DataSet がある場合は、コントロールに連結するテーブルを指定する必要があります。データソースを指定したら、 DataBind メソッドを使用して、データソースをコントロールに連結します。

BaseDataList クラスには、行として表示される各レコードのキーフィールドをデータリストコントロールに格納する DataKeys コレクションが格納されています。これにより、データリストコントロールを持つキーフィールドをコントロールに表示せずに格納できます。通常、キーフィールドは、データソース内の特定のレコードを改訂する更新クエリ文字列の一部として使用されます。コレクションには、 DataKeyField プロパティで指定されたフィールドの値が格納されます。

BaseDataList クラスは、コントロールで選択された項目が変更されると発生する SelectedIndexChanged イベントを提供します。これにより、イベントが発生したときに特定の命令セットを実行するカスタムイベントハンドラを作成できます。

必要条件

名前空間: System.Web.UI.WebControls

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System.Web (System.Web.dll 内)

参照

次の方法で共有

BaseDataList クラス

スレッドセーフ

解説

必要条件

参照

その他のリソース