ButtonColumn クラス

定義

名前空間:

System.Web.UI.WebControls

アセンブリ:

System.Web.dll

ユーザー定義のボタンを格納する DataGrid コントロールの列の種類。

public ref class ButtonColumn : System::Web::UI::WebControls::DataGridColumn

public class ButtonColumn : System.Web.UI.WebControls.DataGridColumn

type ButtonColumn = class
    inherit DataGridColumn

Public Class ButtonColumn
Inherits DataGridColumn

継承

Object

DataGridColumn

ButtonColumn

例

次のコード例では、コントロールの DataGrid クラスを使用ButtonColumnして [追加] ボタンを作成する方法を示します。

private void Page_Init(Object sender, EventArgs e)
{

   // Create dynamic column to add to Columns collection.
   ButtonColumn AddColumn = new ButtonColumn();
   AddColumn.HeaderText="Add Item";
   AddColumn.Text="Add";
   AddColumn.CommandName="Add";
   AddColumn.ButtonType = ButtonColumnType.PushButton;

   // Add column to Columns collection.
   ItemsGrid.Columns.AddAt(2, AddColumn);
}

Private Sub Page_Init(sender As Object, e As EventArgs)
    
    ' Create dynamic column to add to Columns collection.
    Dim AddColumn As New ButtonColumn()
    AddColumn.HeaderText = "Add Item"
    AddColumn.Text = "Add"
    AddColumn.CommandName = "Add"
    AddColumn.ButtonType = ButtonColumnType.PushButton

    
    ' Add column to Columns collection.
    ItemsGrid.Columns.AddAt(2, AddColumn)
End Sub

注釈

コントロール内の ButtonColumn 各行に DataGrid 対応するボタンを作成するには、コントロールの クラスを DataGrid 使用します。 プロパティを設定して、ボタンに表示されるキャプションをText指定します。 プロパティをText設定すると、オブジェクト内のすべてのボタンがButtonColumn同じキャプションを共有します。 または、データ ソース内の ButtonColumn フィールドにボタンをバインドすることもできます。 これにより、ボタンごとに異なるキャプションを表示できます。 指定したフィールドの値は、テキスト キャプションに使用されます。 プロパティを DataTextField 設定して、 を ButtonColumn データ ソース内のフィールドにバインドします。

プロパティを書式設定文字列で設定 DataTextField することで、ボタンに表示されるキャプションの書式を設定できます。

内 ButtonColumn のボタンをクリックすると、イベントが発生します ItemCommand 。 イベントのイベント ハンドラー ItemCommand を指定することで、ボタンがクリックされたときに実行されるアクションをプログラムで制御できます。

既定では、 のボタンがクリックされると、ページの ButtonColumn 検証は実行されません。 ページの検証では、ページ上の検証コントロールに関連付けられている入力コントロールが、検証コントロールによって指定された検証規則にすべて合格するかどうかを決定します。 ボタンがクリックされたときにページ検証を実行するには、 プロパティを CausesValidation に true設定します。

コンストラクター

ButtonColumn()

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

プロパティ

ButtonType	ButtonColumn オブジェクトに表示するボタンの種類を取得または設定します。
CausesValidation	ButtonColumn オブジェクトのボタンがクリックされたときに検証を実行するかどうかを示す値を取得または設定します。
CommandName	ButtonColumn オブジェクトのボタンがクリックされたときに実行するコマンドを表す文字列を取得または設定します。
DataTextField	ButtonColumn オブジェクトにバインドするデータ ソースのフィールド名を取得または設定します。
DataTextFormatString	各ボタンのキャプションの表示形式を指定する文字列を取得または設定します。
DesignMode	列がデザイン モードかどうかを示す値を取得します。 (継承元 DataGridColumn)
FooterStyle	列のフッター セクションのスタイル プロパティを取得します。 (継承元 DataGridColumn)
FooterText	列のフッター セクションに表示されるテキストを取得または設定します。 (継承元 DataGridColumn)
HeaderImageUrl	列のヘッダー セクションに表示するイメージの位置を取得または設定します。 (継承元 DataGridColumn)
HeaderStyle	列のヘッダー セクションのスタイル プロパティを取得します。 (継承元 DataGridColumn)
HeaderText	列のヘッダー セクションに表示されるテキストを取得または設定します。 (継承元 DataGridColumn)
IsTrackingViewState	DataGridColumn オブジェクトが状態を保存するようにマークされているかどうかを判断する値を取得します。 (継承元 DataGridColumn)
ItemStyle	列の項目セルのスタイル プロパティを取得します。 (継承元 DataGridColumn)
Owner	列がメンバーとして含まれている DataGrid コントロールを取得します。 (継承元 DataGridColumn)
SortExpression	並べ替えのために列が選択された場合に、OnSortCommand(DataGridSortCommandEventArgs) メソッドに渡されるフィールドの名前または式を、取得または設定します。 (継承元 DataGridColumn)
Text	ButtonColumn オブジェクトのボタンに表示するキャプションを取得または設定します。
ValidationGroup	ButtonColumn オブジェクトがサーバーにポストバックされるときに、このオブジェクトによって発生する検証の対象となる検証コントロールのグループを取得または設定します。
ViewState	StateBag クラスから派生した列がそのプロパティを格納できるようにする DataGridColumn オブジェクトを取得します。 (継承元 DataGridColumn)
Visible	DataGrid コントロールに列を表示するかどうかを示す値を取得または設定します。 (継承元 DataGridColumn)

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
FormatDataTextValue(Object)	指定された値を DataTextFormatString プロパティで示されている書式に変換します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
Initialize()	ButtonColumn オブジェクトを初期状態にリセットします。
InitializeCell(TableCell, Int32, ListItemType)	ButtonColumn オブジェクト内のセルをリセットして、初期状態にします。
LoadViewState(Object)	DataGridColumn オブジェクトの状態を読み込みます。 (継承元 DataGridColumn)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
OnColumnChanged()	OnColumnsChanged() メソッドを呼び出します。 (継承元 DataGridColumn)
SaveViewState()	DataGridColumn オブジェクトの現在の状態を保存します。 (継承元 DataGridColumn)
ToString()	列の文字列形式を返します。 (継承元 DataGridColumn)
TrackViewState()	サーバー コントロールにビューステートの変更を追跡させ、サーバー コントロールの StateBag オブジェクトに変更を格納できるようにします。 (継承元 DataGridColumn)

明示的なインターフェイスの実装

IStateManager.IsTrackingViewState	列がビューステートの変化を追跡しているかどうかを示す値を取得します。 (継承元 DataGridColumn)
IStateManager.LoadViewState(Object)	以前に保存した状態を読み込みます。 (継承元 DataGridColumn)
IStateManager.SaveViewState()	状態の変化を示すオブジェクトを返します。 (継承元 DataGridColumn)
IStateManager.TrackViewState()	状態変化の追跡を開始します。 (継承元 DataGridColumn)

こちらもご覧ください

• DataGrid
• DataGridColumn
• BoundColumn
• EditCommandColumn
• HyperLinkColumn
• TemplateColumn
• Button
• LinkButton