Bagikan melalui

GridView.Columns Properti

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan kumpulan DataControlField objek yang mewakili bidang kolom dalam GridView kontrol.

public:
 virtual property System::Web::UI::WebControls::DataControlFieldCollection ^ Columns { System::Web::UI::WebControls::DataControlFieldCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.DataControlFieldCollection Columns { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.Columns : System.Web.UI.WebControls.DataControlFieldCollection
Public Overridable ReadOnly Property Columns As DataControlFieldCollection

Nilai Properti

DataControlFieldCollection

DataControlFieldCollection yang berisi semua bidang kolom dalam GridView kontrol.

Atribut
PersistenceModeAttribute

Contoh

Contoh berikut menunjukkan cara mengisi Columns koleksi secara deklaratif.


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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView Columns Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Columns Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        runat="server">
        
        <columns>
          <asp:boundfield datafield="CustomerID" headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName" headertext="Company Name"/>
          <asp:boundfield datafield="Address" headertext="Address"/>
          <asp:boundfield datafield="City" headertext="City"/>
          <asp:boundfield datafield="PostalCode" headertext="Postal Code"/>
          <asp:boundfield datafield="Country" headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView Columns Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Columns Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        runat="server">
        
        <columns>
          <asp:boundfield datafield="CustomerID" headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName" headertext="Company Name"/>
          <asp:boundfield datafield="Address" headertext="Address"/>
          <asp:boundfield datafield="City" headertext="City"/>
          <asp:boundfield datafield="PostalCode" headertext="Postal Code"/>
          <asp:boundfield datafield="Country" headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

Keterangan

Bidang kolom mewakili kolom dalam GridView kontrol. Properti Columns (koleksi) digunakan untuk menyimpan semua bidang kolom yang dideklarasikan secara eksplisit yang dirender dalam GridView kontrol. Anda juga dapat menggunakan Columns koleksi untuk mengelola kumpulan bidang kolom secara terprogram.

Nota

Bidang kolom yang dideklarasikan secara eksplisit dapat digunakan dalam kombinasi dengan bidang kolom yang dihasilkan secara otomatis. Saat keduanya digunakan, bidang kolom yang dinyatakan secara eksplisit dirender terlebih dahulu, diikuti oleh bidang kolom yang dihasilkan secara otomatis. Bidang kolom yang dihasilkan secara otomatis tidak ditambahkan ke Columns koleksi.

Bidang kolom ditampilkan dalam GridView kontrol dalam urutan bidang kolom muncul dalam Columns koleksi. Tabel berikut ini memperlihatkan berbagai kelas bidang kolom yang berasal dari DataControlField kelas dan dapat digunakan dalam Columns koleksi.

Tipe bidang kolom Deskripsi
BoundField Menampilkan nilai bidang dalam sumber data. Ini adalah jenis GridView kolom default kontrol.
ButtonField Menampilkan tombol perintah untuk setiap item dalam GridView kontrol. Ini memungkinkan Anda membuat kolom kontrol tombol kustom, seperti tombol Tambahkan atau Hapus.
CheckBoxField Menampilkan kotak centang untuk setiap item dalam GridView kontrol. Tipe bidang kolom ini umumnya digunakan untuk menampilkan bidang dengan nilai Boolean.
CommandField Menampilkan tombol perintah yang telah ditentukan sebelumnya untuk melakukan operasi pilih, edit, atau hapus.
HyperLinkField Menampilkan nilai bidang dalam sumber data sebagai hyperlink. Tipe bidang kolom ini memungkinkan Anda mengikat bidang kedua ke URL hyperlink.
ImageField Menampilkan gambar untuk setiap item dalam GridView kontrol.
TemplateField Menampilkan konten yang ditentukan pengguna untuk setiap item dalam GridView kontrol, sesuai dengan templat yang ditentukan. Tipe bidang kolom ini memungkinkan Anda membuat bidang kolom kustom.

Meskipun Anda dapat menambahkan bidang kolom secara terprogram ke Columns koleksi, lebih mudah untuk mencantumkan bidang kolom secara deklaratif dalam GridView kontrol lalu menggunakan Visible properti setiap bidang kolom untuk memperlihatkan atau menyembunyikan setiap bidang kolom.

Visible Jika properti bidang kolom diatur ke false, kolom tidak ditampilkan dalam GridView kontrol dan data untuk kolom tidak melakukan perjalanan pulang pergi ke klien. Jika Anda ingin data untuk kolom yang tidak terlihat untuk melakukan perjalanan pulang pergi, tambahkan nama bidang ke DataKeyNames properti .

Berlaku untuk

Lihat juga