ButtonColumn Kelas

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.dll

Jenis kolom untuk DataGrid kontrol yang berisi tombol yang ditentukan pengguna.

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

Warisan

Object

DataGridColumn

ButtonColumn

Contoh

Contoh kode berikut menunjukkan cara menggunakan ButtonColumn kelas dalam DataGrid kontrol untuk membuat tombol Tambahkan .

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

Keterangan

ButtonColumn Gunakan kelas dalam DataGrid kontrol untuk membuat tombol yang sesuai dengan setiap baris dalam DataGrid kontrol. Tentukan caption yang ditampilkan di tombol dengan mengatur Text properti . Jika Anda mengatur Text properti , semua tombol dalam ButtonColumn objek memiliki caption yang sama. Atau, Anda dapat mengikat tombol ButtonColumn ke bidang di sumber data. Ini memungkinkan Anda menampilkan keterangan yang berbeda untuk setiap tombol. Nilai dalam bidang yang ditentukan digunakan untuk teks caption. Atur DataTextField properti untuk mengikat ke ButtonColumn bidang di sumber data.

Anda dapat memformat keterangan yang ditampilkan di tombol dengan mengatur DataTextField properti dengan string pemformatan.

Mengklik tombol di ButtonColumn menaikkan ItemCommand acara. Anda dapat mengontrol tindakan yang dilakukan secara terprogram saat tombol diklik dengan menyediakan penanganan aktivitas untuk peristiwa tersebut ItemCommand .

Secara default, validasi halaman tidak dilakukan saat tombol di klik ButtonColumn . Validasi halaman menentukan apakah kontrol input yang terkait dengan kontrol validasi pada halaman semuanya melewati aturan validasi yang ditentukan oleh kontrol validasi. Untuk melakukan validasi halaman saat tombol diklik, atur properti ke CausesValidationtrue.

Konstruktor

ButtonColumn()

Menginisialisasi instans baru kelas ButtonColumn.

Properti

ButtonType	Mendapatkan atau mengatur jenis tombol untuk ditampilkan dalam ButtonColumn objek.
CausesValidation	Mendapatkan atau mengatur nilai yang menunjukkan apakah validasi dilakukan saat tombol dalam objek diklik ButtonColumn .
CommandName	Mendapatkan atau mengatur string yang mewakili perintah yang akan dilakukan saat tombol dalam objek diklik ButtonColumn .
DataTextField	Mendapatkan atau mengatur nama bidang dari sumber data untuk mengikat objek ButtonColumn .
DataTextFormatString	Mendapatkan atau mengatur string yang menentukan format tampilan untuk caption di setiap tombol.
DesignMode	Mendapatkan nilai yang menunjukkan apakah kolom berada dalam mode desain. (Diperoleh dari DataGridColumn)
FooterStyle	Mendapatkan properti gaya untuk bagian footer kolom. (Diperoleh dari DataGridColumn)
FooterText	Mendapatkan atau mengatur teks yang ditampilkan di bagian footer kolom. (Diperoleh dari DataGridColumn)
HeaderImageUrl	Mendapatkan atau mengatur lokasi gambar untuk ditampilkan di bagian header kolom. (Diperoleh dari DataGridColumn)
HeaderStyle	Mendapatkan properti gaya untuk bagian header kolom. (Diperoleh dari DataGridColumn)
HeaderText	Mendapatkan atau mengatur teks yang ditampilkan di bagian header kolom. (Diperoleh dari DataGridColumn)
IsTrackingViewState	Mendapatkan nilai yang menentukan apakah DataGridColumn objek ditandai untuk menyimpan statusnya. (Diperoleh dari DataGridColumn)
ItemStyle	Mendapatkan properti gaya untuk sel item kolom. (Diperoleh dari DataGridColumn)
Owner	DataGrid Mendapatkan kontrol bahwa kolom adalah anggotanya. (Diperoleh dari DataGridColumn)
SortExpression	Mendapatkan atau mengatur nama bidang atau ekspresi untuk diteruskan ke OnSortCommand(DataGridSortCommandEventArgs) metode saat kolom dipilih untuk pengurutan. (Diperoleh dari DataGridColumn)
Text	Mendapatkan atau mengatur caption yang ditampilkan di tombol ButtonColumn objek.
ValidationGroup	Mendapatkan atau mengatur grup kontrol validasi yang ButtonColumn objeknya menyebabkan validasi saat memposting kembali ke server.
ViewState	StateBag Mendapatkan objek yang memungkinkan kolom yang berasal dari DataGridColumn kelas untuk menyimpan propertinya. (Diperoleh dari DataGridColumn)
Visible	Mendapatkan atau mengatur nilai yang menunjukkan apakah kolom terlihat dalam DataGrid kontrol. (Diperoleh dari DataGridColumn)

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FormatDataTextValue(Object)	Mengonversi nilai yang ditentukan ke format yang ditunjukkan oleh DataTextFormatString properti .
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
Initialize()	Mereset objek ke ButtonColumn status awalnya.
InitializeCell(TableCell, Int32, ListItemType)	Mereset sel dalam objek ke ButtonColumn status awalnya.
LoadViewState(Object)	Memuat status DataGridColumn objek. (Diperoleh dari DataGridColumn)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnColumnChanged()	OnColumnsChanged() Memanggil metode . (Diperoleh dari DataGridColumn)
SaveViewState()	Menyimpan status DataGridColumn objek saat ini. (Diperoleh dari DataGridColumn)
ToString()	Mengembalikan representasi string kolom. (Diperoleh dari DataGridColumn)
TrackViewState()	Menyebabkan pelacakan perubahan status tampilan pada kontrol server sehingga dapat disimpan di objek kontrol StateBag server. (Diperoleh dari DataGridColumn)

Implementasi Antarmuka Eksplisit

IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah kolom melacak perubahan status tampilan. (Diperoleh dari DataGridColumn)
IStateManager.LoadViewState(Object)	Memuat status yang disimpan sebelumnya. (Diperoleh dari DataGridColumn)
IStateManager.SaveViewState()	Mengembalikan objek yang berisi perubahan status. (Diperoleh dari DataGridColumn)
IStateManager.TrackViewState()	Mulai melacak perubahan status. (Diperoleh dari DataGridColumn)

Lihat juga

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