GridView.Columns Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

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