Sdílet prostřednictvím


GridView.Columns Vlastnost

Definice

Získá kolekci DataControlField objektů, které představují pole sloupců v ovládacím GridView prvku.

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

Hodnota vlastnosti

DataControlFieldCollection

A DataControlFieldCollection obsahující všechna pole sloupců v ovládacím GridView prvku.

Atributy

Příklady

Následující příklad ukazuje, jak naplnit kolekci Columns deklarativním způsobem.


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

Poznámky

Pole sloupce představuje sloupec v ovládacím GridView prvku. Vlastnost Columns (kolekce) slouží k uložení všech explicitně deklarovaných polí sloupců, která se v ovládacím GridView prvku vykreslují. Kolekci můžete také použít Columns k programové správě kolekce polí sloupců.

Poznámka

Explicitně deklarovaná pole sloupců lze použít v kombinaci s automaticky generovanými sloupcovými poli. Při použití obou polí se explicitně deklarovaná pole sloupců vykreslí jako první a potom automaticky vygenerovaná pole sloupců. Automaticky generovaná pole sloupců se do Columns kolekce nepřidají.

Pole sloupců se zobrazí v ovládacím GridView prvku v pořadí, v jakém se pole sloupců zobrazují v kolekci Columns . Následující tabulka ukazuje různé třídy polí sloupců, které jsou odvozeny od DataControlField třídy a lze je použít v kolekci Columns .

Typ pole sloupce Description
BoundField Zobrazí hodnotu pole ve zdroji dat. Toto je výchozí typ GridView sloupce ovládacího prvku.
ButtonField Zobrazí příkazové tlačítko pro každou položku v ovládacím GridView prvku. To vám umožní vytvořit sloupec vlastních ovládacích prvků tlačítek, jako je například tlačítko Přidat nebo Odebrat.
CheckBoxField Zobrazí zaškrtávací políčko pro každou položku v ovládacím GridView prvku. Tento typ pole sloupce se běžně používá k zobrazení polí s logickou hodnotou.
CommandField Zobrazí předdefinovaná příkazová tlačítka pro provádění operací výběru, úprav nebo odstranění.
HyperLinkField Zobrazí hodnotu pole ve zdroji dat jako hypertextový odkaz. Tento typ pole sloupce umožňuje vytvořit vazbu druhého pole na adresu URL hypertextového odkazu.
ImageField Zobrazí obrázek pro každou položku v ovládacím GridView prvku.
TemplateField Zobrazí uživatelem definovaný obsah pro každou položku v ovládacím GridView prvku podle zadané šablony. Tento typ pole sloupce umožňuje vytvořit vlastní pole sloupce.

I když do kolekce můžete pole sloupců Columns přidávat prostřednictvím kódu programu, je jednodušší v ovládacím GridView prvku zobrazit nebo skrýt pole sloupců deklarativním způsobem a potom pomocí Visible vlastnosti každého pole sloupce zobrazit nebo skrýt jednotlivá pole sloupce.

Visible Pokud je vlastnost pole sloupce nastavena na false, sloupec není zobrazen v GridView ovládacím prvku a data pro sloupec neprovádí zpáteční cestu klientovi. Pokud chcete, aby data pro sloupec, který není viditelný, zaokrouhlit, přidejte název pole do DataKeyNames vlastnosti.

Platí pro

Viz také