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

ButtonFieldBase コンストラクタ

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

ButtonFieldBase クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Protected Sub New

Visual Basic (使用法)

Dim instance As New ButtonFieldBase

C#

protected ButtonFieldBase ()

C++

protected:
ButtonFieldBase ()

J#

protected ButtonFieldBase ()

JScript

protected function ButtonFieldBase ()

解説

ButtonFieldBase クラスは抽象クラスであるため、ButtonFieldBase オブジェクトを直接作成することはできません。

プラットフォーム

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 クラス
ButtonFieldBase メンバ
System.Web.UI.WebControls 名前空間
ButtonField クラス
CommandField

ButtonFieldBase プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	AccessibleHeaderText	一部のコントロールの AbbreviatedText プロパティ値として表示されるテキストを取得または設定します。 ( DataControlField から継承されます。)
	ButtonType	ボタン フィールドに表示するボタンの種類を取得または設定します。
	CausesValidation	ButtonFieldBase オブジェクトのボタンがクリックされたときに検証を実行するかどうかを示す値を取得または設定します。
	ControlStyle	DataControlField オブジェクトに格納されているすべての Web サーバー コントロールのスタイルを取得または設定します。 ( DataControlField から継承されます。)
	FooterStyle	データ コントロール フィールドのフッターのスタイルを取得または設定します。 ( DataControlField から継承されます。)
	FooterText	データ コントロール フィールドのフッター項目に表示されるテキストを取得または設定します。 ( DataControlField から継承されます。)
	HeaderImageUrl	データ コントロール フィールドのヘッダー項目に表示されるイメージの URL を取得または設定します。 ( DataControlField から継承されます。)
	HeaderStyle	データ コントロール フィールドのヘッダーのスタイルを取得または設定します。 ( DataControlField から継承されます。)
	HeaderText	データ コントロール フィールドのヘッダー項目に表示されるテキストを取得または設定します。 ( DataControlField から継承されます。)
	InsertVisible	DataControlField オブジェクトの親データ バインド コントロールが挿入モードの場合に、このオブジェクトが表示されるかどうかを示す値を取得します。 ( DataControlField から継承されます。)
	ItemStyle	データ コントロール フィールドで表示されるテキスト ベースの内容のスタイルを取得します。 ( DataControlField から継承されます。)
	ShowHeader	ButtonFieldBase オブジェクトにヘッダー セクションを表示するかどうかを示す値を取得または設定します。
	SortExpression	データ ソース コントロールでデータを並べ替えるために使用される並べ替え式を、取得または設定します。 ( DataControlField から継承されます。)
	ValidationGroup	ButtonFieldBase オブジェクトのボタンがクリックされたときに検証する検証コントロールのグループの名前を取得または設定します。
	Visible	データ コントロール フィールドを表示するかどうかを示す値を取得または設定します。 ( DataControlField から継承されます。)

プロテクト プロパティ

	名前	説明
	Control	DataControlField オブジェクトが関連付けられているデータ コントロールの参照を取得します。 ( DataControlField から継承されます。)
	DesignMode	デザイン時環境で、現在データ コントロール フィールドが表示されているかどうかを示す値を取得します。 ( DataControlField から継承されます。)
	IsTrackingViewState	DataControlField オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。 ( DataControlField から継承されます。)
	ViewState	同一のページに対する複数の要求にわたって、DataControlField オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。 ( DataControlField から継承されます。)

参照

関連項目

ButtonFieldBase クラス
System.Web.UI.WebControls 名前空間
GridView
Columns
ShowHeader
DetailsView
Fields
BoundField クラス
ButtonField クラス
CheckBoxField
CommandField
DataControlField
HyperLinkField
TemplateField

ButtonFieldBase メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	ExtractValuesFromCell	現在のテーブル セルからデータ コントロール フィールドの値を抽出し、指定した IDictionary コレクションにその値を追加します。 ( DataControlField から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Initialize	データ コントロール フィールドのインスタンスの基本的な初期化を実行します。 ( DataControlField から継承されます。)
	InitializeCell	セルのコントロールのコレクションにテキストまたはコントロールを追加します。 ( DataControlField から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	この DataControlField オブジェクトを表す文字列を返します。 ( DataControlField から継承されます。)
	ValidateSupportsCallback	派生クラス内でオーバーライドされた場合は、フィールドに格納されているコントロールがコールバックをサポートすることを通知します。 ( DataControlField から継承されます。)

プロテクト メソッド

	名前	説明
	CloneField	現在の DataControlField 派生オブジェクトのコピーを作成します。 ( DataControlField から継承されます。)
	CopyProperties	オーバーライドされます。 ButtonFieldBase クラスから派生した現在のオブジェクトのプロパティを、指定した DataControlField オブジェクトにコピーします。
	CreateField	派生クラス内でオーバーライドされた場合は、空の DataControlField 派生オブジェクトを作成します。 ( DataControlField から継承されます。)
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	LoadViewState	データ ソース ビューの、以前保存したビューステートを復元します。 ( DataControlField から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnFieldChanged	FieldChanged イベントを発生させます。 ( DataControlField から継承されます。)
	SaveViewState	ページがサーバーにポストバックされた時間以降に発生した、DataControlField ビューステートへの変更を保存します。 ( DataControlField から継承されます。)
	TrackViewState	DataControlField オブジェクトがそのビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState プロパティに格納して、同じページに対する複数の要求にわたって永続化できます。 ( DataControlField から継承されます。)

参照

関連項目

ButtonFieldBase クラス
System.Web.UI.WebControls 名前空間
GridView
Columns
ShowHeader
DetailsView
Fields
BoundField クラス
ButtonField クラス
CheckBoxField
CommandField
DataControlField
HyperLinkField
TemplateField

ButtonFieldBase メンバ

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

ButtonFieldBase データ型で公開されるメンバを以下の表に示します。

プロテクト コンストラクタ

	名前	説明
	ButtonFieldBase	ButtonFieldBase クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	AccessibleHeaderText	一部のコントロールの AbbreviatedText プロパティ値として表示されるテキストを取得または設定します。(DataControlField から継承されます。)
	ButtonType	ボタン フィールドに表示するボタンの種類を取得または設定します。
	CausesValidation	ButtonFieldBase オブジェクトのボタンがクリックされたときに検証を実行するかどうかを示す値を取得または設定します。
	ControlStyle	DataControlField オブジェクトに格納されているすべての Web サーバー コントロールのスタイルを取得または設定します。(DataControlField から継承されます。)
	FooterStyle	データ コントロール フィールドのフッターのスタイルを取得または設定します。(DataControlField から継承されます。)
	FooterText	データ コントロール フィールドのフッター項目に表示されるテキストを取得または設定します。(DataControlField から継承されます。)
	HeaderImageUrl	データ コントロール フィールドのヘッダー項目に表示されるイメージの URL を取得または設定します。(DataControlField から継承されます。)
	HeaderStyle	データ コントロール フィールドのヘッダーのスタイルを取得または設定します。(DataControlField から継承されます。)
	HeaderText	データ コントロール フィールドのヘッダー項目に表示されるテキストを取得または設定します。(DataControlField から継承されます。)
	InsertVisible	DataControlField オブジェクトの親データ バインド コントロールが挿入モードの場合に、このオブジェクトが表示されるかどうかを示す値を取得します。(DataControlField から継承されます。)
	ItemStyle	データ コントロール フィールドで表示されるテキスト ベースの内容のスタイルを取得します。(DataControlField から継承されます。)
	ShowHeader	ButtonFieldBase オブジェクトにヘッダー セクションを表示するかどうかを示す値を取得または設定します。
	SortExpression	データ ソース コントロールでデータを並べ替えるために使用される並べ替え式を、取得または設定します。(DataControlField から継承されます。)
	ValidationGroup	ButtonFieldBase オブジェクトのボタンがクリックされたときに検証する検証コントロールのグループの名前を取得または設定します。
	Visible	データ コントロール フィールドを表示するかどうかを示す値を取得または設定します。(DataControlField から継承されます。)

プロテクト プロパティ

	名前	説明
	Control	DataControlField オブジェクトが関連付けられているデータ コントロールの参照を取得します。(DataControlField から継承されます。)
	DesignMode	デザイン時環境で、現在データ コントロール フィールドが表示されているかどうかを示す値を取得します。(DataControlField から継承されます。)
	IsTrackingViewState	DataControlField オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。(DataControlField から継承されます。)
	ViewState	同一のページに対する複数の要求にわたって、DataControlField オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。(DataControlField から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	ExtractValuesFromCell	現在のテーブル セルからデータ コントロール フィールドの値を抽出し、指定した IDictionary コレクションにその値を追加します。 (DataControlField から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Initialize	データ コントロール フィールドのインスタンスの基本的な初期化を実行します。 (DataControlField から継承されます。)
	InitializeCell	セルのコントロールのコレクションにテキストまたはコントロールを追加します。 (DataControlField から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	この DataControlField オブジェクトを表す文字列を返します。 (DataControlField から継承されます。)
	ValidateSupportsCallback	派生クラス内でオーバーライドされた場合は、フィールドに格納されているコントロールがコールバックをサポートすることを通知します。 (DataControlField から継承されます。)

プロテクト メソッド

	名前	説明
	CloneField	現在の DataControlField 派生オブジェクトのコピーを作成します。 (DataControlField から継承されます。)
	CopyProperties	オーバーライドされます。 ButtonFieldBase クラスから派生した現在のオブジェクトのプロパティを、指定した DataControlField オブジェクトにコピーします。
	CreateField	派生クラス内でオーバーライドされた場合は、空の DataControlField 派生オブジェクトを作成します。 (DataControlField から継承されます。)
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	LoadViewState	データ ソース ビューの、以前保存したビューステートを復元します。 (DataControlField から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnFieldChanged	FieldChanged イベントを発生させます。 (DataControlField から継承されます。)
	SaveViewState	ページがサーバーにポストバックされた時間以降に発生した、DataControlField ビューステートへの変更を保存します。 (DataControlField から継承されます。)
	TrackViewState	DataControlField オブジェクトがそのビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState プロパティに格納して、同じページに対する複数の要求にわたって永続化できます。 (DataControlField から継承されます。)

参照

関連項目

ButtonFieldBase クラス
System.Web.UI.WebControls 名前空間
GridView
Columns
ShowHeader
DetailsView
Fields
BoundField クラス
ButtonField クラス
CheckBoxField
CommandField
DataControlField
HyperLinkField
TemplateField