Sdílet prostřednictvím

GridView.Columns Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

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 , která obsahuje všechna pole sloupců v ovládacím GridView prvku.

Atributy
PersistenceModeAttribute

Příklady

Následující příklad ukazuje, jak naplnit Columns kolekci 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 vykreslují v ovládacím GridView prvku. 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 za nimi automaticky vygenerovaná pole sloupců. Automaticky generovaná pole sloupců se do Columns kolekce nepřidají.

Pole sloupců se zobrazují v ovládacím GridView prvku v pořadí, v jakém se pole sloupců zobrazují v kolekci Columns . Následující tabulka uvádí různé třídy polí sloupců odvozené 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. Díky tomu můžete 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 svázat druhé pole s adresou 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ů přidat prostřednictvím kódu programu, je jednodušší vypsat pole Columns sloupců v ovládacím GridView prvku deklarativním způsobem a pak pomocí Visible vlastnosti každého pole sloupce zobrazit nebo skrýt každé pole sloupce.

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

Platí pro

Viz také