Aracılığıyla paylaş


GridView.Columns Özellik

Tanım

Denetimdeki DataControlField sütun alanlarını temsil eden nesne GridView koleksiyonunu alır.

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

Özellik Değeri

DataControlFieldCollection

DataControlFieldCollection Denetimdeki tüm sütun alanlarını GridView içeren A.

Öznitelikler

Örnekler

Aşağıdaki örnekte, koleksiyonu bildirimli olarak nasıl doldurduğunuz Columns gösterilmektedir.


<%@ 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>

Açıklamalar

Sütun alanı, denetimdeki bir GridView sütunu temsil eder. Columns özelliği (koleksiyon), denetimde GridView işlenen açıkça bildirilen tüm sütun alanlarını depolamak için kullanılır. Sütun alanları koleksiyonunu program aracılığıyla yönetmek için de koleksiyonunu kullanabilirsiniz Columns .

Not

Açıkça bildirilen sütun alanları, otomatik olarak oluşturulan sütun alanlarıyla birlikte kullanılabilir. Her ikisi de kullanıldığında, açıkça bildirilen sütun alanları önce işlenir, ardından otomatik olarak oluşturulan sütun alanları gelir. Otomatik olarak oluşturulan sütun alanları koleksiyona Columns eklenmez.

Sütun alanları, denetimde GridView sütun alanlarının koleksiyonda görünme sırasına Columns göre görüntülenir. Aşağıdaki tabloda, sınıfından türetilen DataControlField ve koleksiyonda Columns kullanılabilecek farklı sütun alanı sınıfları gösterilmektedir.

Sütun alanı türü Description
BoundField Veri kaynağındaki bir alanın değerini görüntüler. Bu, denetimin varsayılan sütun türüdür GridView .
ButtonField Denetimdeki GridView her öğe için bir komut düğmesi görüntüler. Bu, Ekle veya Kaldır düğmesi gibi özel düğme denetimlerinden oluşan bir sütun oluşturmanıza olanak tanır.
CheckBoxField Denetimdeki GridView her öğe için bir onay kutusu görüntüler. Bu sütun alanı türü genellikle Boole değeri olan alanları görüntülemek için kullanılır.
CommandField Seçme, düzenleme veya silme işlemlerini gerçekleştirmek için önceden tanımlanmış komut düğmelerini görüntüler.
HyperLinkField Veri kaynağındaki bir alanın değerini köprü olarak görüntüler. Bu sütun alanı türü, köprü url'sine ikinci bir alan bağlamanızı sağlar.
ImageField Denetimdeki GridView her öğe için bir görüntü görüntüler.
TemplateField Belirtilen şablona göre denetimdeki GridView her öğe için kullanıcı tanımlı içeriği görüntüler. Bu sütun alanı türü, özel bir sütun alanı oluşturmanıza olanak tanır.

Sütun alanlarını koleksiyona program aracılığıyla ekleyebilmenize Columns rağmen, denetimde GridView sütun alanlarını bildirimli olarak listelemek ve her sütun alanını göstermek veya gizlemek için her sütun alanının özelliğini kullanmak Visible daha kolaydır.

Visible Sütun alanının özelliği olarak falseayarlanırsa, sütun denetimde GridView görüntülenmez ve sütunun verileri istemciye gidiş dönüş yapmaz. Görünür olmayan bir sütunun verilerinin gidiş dönüş yapmasını istiyorsanız, alan adını özelliğine DataKeyNames ekleyin.

Şunlara uygulanır

Ayrıca bkz.