ButtonFieldBase クラス

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

ButtonFieldBase クラス

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

ButtonField クラスまたは CommandField クラスなど、ボタン フィールドの抽象基本クラスとして機能します。ButtonFieldBase クラスは、すべてのボタン フィールドに共通のメソッドおよびプロパティを提供します。

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

Visual Basic (宣言)

Public MustInherit Class
 ButtonFieldBase
    Inherits DataControlField

Visual Basic (使用法)

Dim instance As ButtonFieldBase

C#

public abstract class ButtonFieldBase : DataControlField

C++

public ref class ButtonFieldBase abstract :
 public DataControlField

J#

public abstract class ButtonFieldBase extends
 DataControlField

JScript

public abstract class ButtonFieldBase extends
 DataControlField

解説

ButtonFieldBase クラスはボタン フィールドの抽象基本クラスであり、すべてのボタン フィールドに共通のメソッドおよびプロパティを持ちます。このクラスは抽象クラスであるため、このクラスのインスタンスを直接作成することはできません。代わりに、ButtonField クラスまたは CommandField クラスなど、ButtonFieldBase クラスから継承する非抽象クラスのインスタンスを作成する必要があります。

ButtonFieldBase から派生したオブジェクトは、表示されるレコードごとに 1 つ以上のボタンを表示するために、データ バインド コントロール (GridView コントロール、DetailsView コントロールなど) が使用します。ボタン フィールドは、それが使用されているデータ バインド コントロールによって表示が異なります。たとえば、ボタン フィールドは、GridView コントロールでは列として表示され、DetailsView コントロールでは行として表示されます。

ボタン フィールドのボタンをクリックすると、親データ バインド コントロールのコマンド イベントが発生します。コマンド イベントのイベント ハンドラを作成すると、ボタンがクリックされたときに実行するカスタム ルーチンを提供できます。

メモ
GridView コントロールは RowCommand イベントを発生させ、DetailsView コントロールは ItemCommand イベントを発生させます。

表示するボタンの種類を指定するには、ButtonType プロパティを使用します。ButtonFieldBase オブジェクトのヘッダー セクションを表示または非表示にするには、ShowHeader プロパティを設定します。

メモ
一部のデータ バインド コントロール (GridView コントロールなど) では、コントロールのヘッダー セクション全体を表示または非表示にできます。これらのデータ バインド コントロールは、個別のボタン フィールドの ShowHeader プロパティをサポートしていません。データ バインド コントロールのヘッダー セクション (存在する場合) 全体を表示または非表示にするには、コントロールの ShowHeader プロパティを使用します。

継承時の注意 ButtonFieldBase クラスから継承する場合は、CopyProperties のメンバをオーバーライドする必要があります。

.NET Framework のセキュリティ

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

継承階層

System.Object
   System.Web.UI.WebControls.DataControlField
    System.Web.UI.WebControls.ButtonFieldBase
       System.Web.UI.WebControls.ButtonField
       System.Web.UI.WebControls.CommandField

スレッド セーフ

この型の 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

参照

関連項目
ButtonFieldBase メンバ
System.Web.UI.WebControls 名前空間
GridView
Columns
ShowHeader
DetailsView
Fields
BoundField クラス
ButtonField クラス
CheckBoxField
CommandField
DataControlField
HyperLinkField
TemplateField