ButtonField Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili bidang yang ditampilkan sebagai tombol dalam kontrol terikat data.

public ref class ButtonField : System::Web::UI::WebControls::ButtonFieldBase

public class ButtonField : System.Web.UI.WebControls.ButtonFieldBase

type ButtonField = class
    inherit ButtonFieldBase

Public Class ButtonField
Inherits ButtonFieldBase

Warisan: Object

DataControlField

ButtonFieldBase
ButtonField

Contoh

Contoh kode berikut menunjukkan cara menggunakan ButtonField objek untuk menampilkan kolom tombol perintah dalam GridView kontrol.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void CustomersGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {
  
    // If multiple ButtonField column fields are used, use the
    // CommandName property to determine which button was clicked.
    if(e.CommandName=="Select")
    {
    
      // Convert the row index stored in the CommandArgument
      // property to an Integer.
      int index = Convert.ToInt32(e.CommandArgument);    
    
      // Get the last name of the selected author from the appropriate
      // cell in the GridView control.
      GridViewRow selectedRow = CustomersGridView.Rows[index];
      TableCell contactName = selectedRow.Cells[1];
      string contact = contactName.Text;  
    
      // Display the selected author.
      Message.Text = "You selected " + contact + ".";
      
    }
    
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ButtonField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>
                    
      <!-- Populate the Columns collection declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Button" 
            commandname="Select"
            headertext="Select Customer" 
            text="Select"/>
          <asp:boundfield datafield="CompanyName" 
            headertext="Company Name"/>
          <asp:boundfield datafield="ContactName" 
            headertext="Contact Name"/>
                
        </columns>
                
      </asp:gridview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
          runat="server">
        </asp:sqldatasource>
            
    </form>
  </body>
</html>


<%@ Page language="VB" %>


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    Sub CustomersGridView_RowCommand(ByVal sender As Object, ByVal e As GridViewCommandEventArgs)
  
        ' If multiple ButtonField column fields are used, use the
        ' CommandName property to determine which button was clicked.
        If e.CommandName = "Select" Then
    
            ' Convert the row index stored in the CommandArgument
            ' property to an Integer.
            Dim index As Integer = Convert.ToInt32(e.CommandArgument)
    
            ' Get the last name of the selected author from the appropriate
            ' cell in the GridView control.
            Dim selectedRow As GridViewRow = CustomersGridView.Rows(index)
            Dim contactCell As TableCell = selectedRow.Cells(1)
            Dim contact As String = contactCell.Text
    
            ' Display the selected author.
            Message.Text = "You selected " & contact & "."
      
        End If
    
    End Sub
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>ButtonField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>
                    
      <!-- Populate the Columns collection declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Button" 
            commandname="Select"
            headertext="Select Customer" 
            text="Select"/>
          <asp:boundfield datafield="CompanyName" 
            headertext="Company Name"/>
          <asp:boundfield datafield="ContactName" 
            headertext="Contact Name"/>
                
        </columns>
                
      </asp:gridview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
          runat="server">
        </asp:sqldatasource>
            
    </form>
  </body>
</html>

Keterangan

Kelas ButtonField digunakan oleh kontrol terikat data (seperti GridView dan DetailsView) untuk menampilkan tombol untuk setiap rekaman yang ditampilkan. Objek ButtonField ditampilkan secara berbeda tergantung pada kontrol terikat data tempat objek digunakan. Misalnya, GridView kontrol menampilkan ButtonField objek sebagai kolom, sementara DetailsView kontrol menampilkannya sebagai baris.

Mengklik tombol di bidang tombol akan menaikkan peristiwa perintah kontrol terikat data induk. Anda dapat menyediakan rutinitas kustom untuk dilakukan saat tombol perintah diklik dengan menyediakan penanganan aktivitas untuk peristiwa perintah.

Catatan

GridView Kontrol menaikkan RowCommand peristiwa, sementara DetailsView kontrol menaikkan ItemCommand peristiwa.

Untuk menentukan indeks rekaman yang menaikkan peristiwa perintah, gunakan CommandArgument properti argumen peristiwa yang diteruskan ke peristiwa perintah untuk kontrol terikat data. Kelas ButtonField secara otomatis mengisi CommandArgument properti dengan nilai indeks yang sesuai.

Untuk menentukan jenis tombol yang akan ditampilkan, gunakan ButtonType properti . Saat menampilkan tautan atau tombol perintah, gunakan Text properti untuk menentukan caption untuk ditampilkan di tombol.

Catatan

Jika Anda mengatur Text properti , semua tombol dalam ButtonField berbagi caption yang sama.

Atau, Anda dapat mengikat objek ke ButtonField bidang di sumber data. Ini memungkinkan Anda menampilkan keterangan yang berbeda untuk tombol dalam ButtonField objek. Nilai yang ada di bidang yang ditentukan digunakan untuk keterangan teks tombol. Atur DataTextField properti untuk mengikat ButtonField objek ke bidang di sumber data.

Saat menampilkan tombol gambar, gunakan ImageUrl properti untuk menentukan gambar yang akan ditampilkan untuk tombol dalam ButtonField objek.

Catatan

Semua tombol dalam ButtonField objek memiliki gambar yang sama.

Anda dapat menyembunyikan ButtonField objek dalam kontrol terikat data dengan mengatur properti ke Visiblefalse.

Objek ButtonField memungkinkan Anda untuk menyesuaikan bagian header dan footer-nya. Untuk menampilkan caption di bagian header atau footer, atur HeaderText properti atau FooterText . Alih-alih menampilkan teks di bagian header, Anda dapat menampilkan gambar dengan mengatur HeaderImageUrl properti . Untuk menyembunyikan bagian header dalam ButtonField objek, atur properti ke ShowHeaderfalse.

Catatan

Beberapa kontrol terikat data (seperti GridView kontrol) hanya dapat menampilkan atau menyembunyikan seluruh bagian header kontrol. Kontrol terikat data ini tidak mendukung ShowHeader properti untuk bidang tombol individual. Untuk memperlihatkan atau menyembunyikan seluruh bagian header kontrol terikat data (jika tersedia), gunakan ShowHeader properti untuk kontrol.

Anda juga dapat menyesuaikan tampilan ButtonField objek (warna font, warna latar belakang, dan sebagainya) dengan mengatur properti gaya untuk berbagai bagian bidang. Tabel berikut ini mencantumkan properti gaya yang berbeda.

Properti gaya	Pengaturan gaya untuk
ControlStyle	Kontrol server Web anak dari ButtonField.
FooterStyle	Bagian footer dari ButtonField.
HeaderStyle	Bagian header dari ButtonField.
ItemStyle	Item data di ButtonField.

Konstruktor

ButtonField()

Menginisialisasi instans baru kelas ButtonField.

Properti

AccessibleHeaderText	Mendapatkan atau mengatur teks yang dirender sebagai `AbbreviatedText` nilai properti di beberapa kontrol. (Diperoleh dari DataControlField)
ButtonType	Mendapatkan atau mengatur jenis tombol untuk ditampilkan di bidang tombol. (Diperoleh dari ButtonFieldBase)
CausesValidation	Mendapatkan atau mengatur nilai yang menunjukkan apakah validasi dilakukan saat tombol dalam objek diklik ButtonFieldBase . (Diperoleh dari ButtonFieldBase)
CommandName	Mendapatkan atau mengatur string yang mewakili tindakan yang akan dilakukan saat tombol dalam objek diklik ButtonField .
Control	Mendapatkan referensi ke kontrol data yang DataControlField terkait dengan objek. (Diperoleh dari DataControlField)
ControlStyle	Mendapatkan gaya kontrol server Web apa pun yang terkandung oleh DataControlField objek . (Diperoleh dari DataControlField)
DataTextField	Mendapatkan atau mengatur nama bidang data yang nilainya terikat ke Text properti Button kontrol yang dirender oleh ButtonField objek.
DataTextFormatString	Mendapatkan atau mengatur string yang menentukan format tampilan untuk nilai bidang.
DesignMode	Mendapatkan nilai yang menunjukkan apakah bidang kontrol data saat ini dilihat di lingkungan waktu desain. (Diperoleh dari DataControlField)
FooterStyle	Mendapatkan atau mengatur gaya footer bidang kontrol data. (Diperoleh dari DataControlField)
FooterText	Mendapatkan atau mengatur teks yang ditampilkan dalam item footer bidang kontrol data. (Diperoleh dari DataControlField)
HeaderImageUrl	Mendapatkan atau mengatur URL gambar yang ditampilkan di item header bidang kontrol data. (Diperoleh dari DataControlField)
HeaderStyle	Mendapatkan atau mengatur gaya header bidang kontrol data. (Diperoleh dari DataControlField)
HeaderText	Mendapatkan atau mengatur teks yang ditampilkan di item header bidang kontrol data. (Diperoleh dari DataControlField)
ImageUrl	Mendapatkan atau mengatur gambar yang akan ditampilkan untuk setiap tombol dalam ButtonField objek.
InsertVisible	Mendapatkan nilai yang menunjukkan apakah DataControlField objek terlihat ketika kontrol terikat data induknya berada dalam mode sisipkan. (Diperoleh dari DataControlField)
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah DataControlField objek menyimpan perubahan pada status tampilannya. (Diperoleh dari DataControlField)
ItemStyle	Mendapatkan gaya konten berbasis teks apa pun yang ditampilkan oleh bidang kontrol data. (Diperoleh dari DataControlField)
ShowHeader	Mendapatkan atau mengatur nilai yang menunjukkan apakah bagian header ditampilkan dalam ButtonFieldBase objek. (Diperoleh dari ButtonFieldBase)
SortExpression	Mendapatkan atau mengatur ekspresi pengurutan yang digunakan oleh kontrol sumber data untuk mengurutkan data. (Diperoleh dari DataControlField)
Text	Mendapatkan atau mengatur caption statis yang ditampilkan untuk setiap tombol dalam ButtonField objek.
ValidateRequestMode	Mendapatkan atau menetapkan nilai yang menentukan apakah kontrol memvalidasi input klien. (Diperoleh dari DataControlField)
ValidationGroup	Mendapatkan atau mengatur nama grup kontrol validasi untuk divalidasi saat tombol dalam objek diklik ButtonFieldBase . (Diperoleh dari ButtonFieldBase)
ViewState	Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status DataControlField tampilan objek di beberapa permintaan untuk halaman yang sama. (Diperoleh dari DataControlField)
Visible	Mendapatkan atau menetapkan nilai yang menunjukkan apakah bidang kontrol data dirender. (Diperoleh dari DataControlField)

Metode

CloneField()	Membuat salinan duplikat objek -turunan saat ini DataControlField. (Diperoleh dari DataControlField)
CopyProperties(DataControlField)	Menyalin properti objek saat ini ButtonField ke objek yang ditentukan DataControlField .
CreateField()	Membuat dan mengembalikan instans ButtonField baru kelas.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Mengekstrak nilai bidang kontrol data dari sel tabel saat ini dan menambahkan nilai ke koleksi yang ditentukan IDictionary . (Diperoleh dari DataControlField)
FormatDataTextValue(Object)	Memformat nilai bidang yang ditentukan untuk sel dalam ButtonField objek.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
Initialize(Boolean, Control)	Menginisialisasi objek saat ini ButtonField .
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Menginisialisasi objek yang ditentukan DataControlFieldCell ke status baris yang ditentukan.
LoadViewState(Object)	Memulihkan status tampilan sumber data yang sebelumnya disimpan. (Diperoleh dari DataControlField)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnFieldChanged()	Memunculkan kejadian `FieldChanged`. (Diperoleh dari DataControlField)
SaveViewState()	Menyimpan perubahan yang dibuat pada DataControlField status tampilan sejak halaman diposting kembali ke server. (Diperoleh dari DataControlField)
ToString()	Mengembalikan string yang mewakili objek ini DataControlField . (Diperoleh dari DataControlField)
TrackViewState()	DataControlField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari DataControlField)
ValidateSupportsCallback()	Menentukan apakah kontrol yang terkandung dalam ButtonField panggilan balik dukungan objek.

Implementasi Antarmuka Eksplisit

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Mendapatkan atau mengatur skema yang terkait dengan objek ini DataControlField . (Diperoleh dari DataControlField)
IStateManager.IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah DataControlField objek menyimpan perubahan pada status tampilannya. (Diperoleh dari DataControlField)
IStateManager.LoadViewState(Object)	Memulihkan status tampilan bidang kontrol data yang sebelumnya disimpan. (Diperoleh dari DataControlField)
IStateManager.SaveViewState()	Menyimpan perubahan yang dibuat pada DataControlField status tampilan sejak halaman diposting kembali ke server. (Diperoleh dari DataControlField)
IStateManager.TrackViewState()	DataControlField Menyebabkan objek melacak perubahan pada status tampilannya sehingga dapat disimpan di properti kontrol ViewState dan bertahan di seluruh permintaan untuk halaman yang sama. (Diperoleh dari DataControlField)

Berlaku untuk

Bagikan melalui

ButtonField Kelas

Definisi

Contoh

Keterangan

Konstruktor

Properti

Metode

Implementasi Antarmuka Eksplisit

Berlaku untuk

Lihat juga

Sumber Daya Tambahan: