GridView.Columns Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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: PersistenceModeAttribute

Ö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