ButtonColumn クラス

定義

ユーザー定義のボタンを格納する 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
継承
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 検証は実行されません。 ページの検証では、ページ上の検証コントロールに関連付けられている入力コントロールが、検証コントロールによって指定された検証規則にすべて合格するかどうかを決定します。 ボタンがクリックされたときにページ検証を実行するには、 プロパティを CausesValidationtrue設定します。

コンストラクター

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)

適用対象

こちらもご覧ください