GridView.Columns Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene un insieme di oggetti DataControlField che rappresentano i campi colonna in un controllo GridView.

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

Valore della proprietà

DataControlFieldCollection

Un oggetto DataControlFieldCollection contenente tutti i campi colonna all'interno del controllo GridView.

Attributi: PersistenceModeAttribute

Esempio

Nell'esempio seguente viene illustrato come popolare la Columns raccolta in modo dichiarativo.


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

Commenti

Un campo colonna rappresenta una colonna in un GridView controllo . La Columns proprietà (raccolta) viene utilizzata per archiviare tutti i campi di colonna dichiarati in modo esplicito di cui viene eseguito il GridView rendering nel controllo . È anche possibile utilizzare la Columns raccolta per gestire a livello di codice la raccolta di campi di colonna.

Nota

I campi colonna dichiarati in modo esplicito possono essere usati in combinazione con campi di colonna generati automaticamente. Quando vengono usati entrambi, viene eseguito il rendering dei campi colonna dichiarati in modo esplicito, seguiti dai campi colonna generati automaticamente. I campi di colonna generati automaticamente non vengono aggiunti alla Columns raccolta.

I campi della colonna vengono visualizzati nel GridView controllo nell'ordine in cui i campi della colonna vengono visualizzati nell'insieme Columns . La tabella seguente illustra le diverse classi di campi di colonna che derivano dalla DataControlField classe e che possono essere usate nella Columns raccolta.

Tipo di campo colonna	Descrizione
BoundField	Visualizza il valore di un campo in un'origine dati. Si tratta del tipo di colonna predefinito del GridView controllo.
ButtonField	Visualizza un pulsante di comando per ogni elemento nel GridView controllo . In questo modo è possibile creare una colonna di controlli pulsante personalizzati, ad esempio il pulsante Aggiungi o Rimuovi.
CheckBoxField	Visualizza una casella di controllo per ogni elemento nel GridView controllo . Questo tipo di campo di colonna viene comunemente usato per visualizzare i campi con un valore booleano.
CommandField	Visualizza i pulsanti di comando predefiniti per eseguire operazioni di selezione, modifica o eliminazione.
HyperLinkField	Visualizza il valore di un campo in un'origine dati come collegamento ipertestuale. Questo tipo di campo colonna consente di associare un secondo campo all'URL del collegamento ipertestuale.
ImageField	Visualizza un'immagine per ogni elemento nel GridView controllo .
TemplateField	Visualizza il contenuto definito dall'utente per ogni elemento del GridView controllo, in base a un modello specificato. Questo tipo di campo colonna consente di creare un campo colonna personalizzato.

Sebbene sia possibile aggiungere campi di colonna a livello di codice all'insieme Columns , è più semplice elencare i campi di colonna in modo dichiarativo nel GridView controllo e quindi usare la Visible proprietà di ogni campo colonna per visualizzare o nascondere ogni campo di colonna.

Se la Visible proprietà di un campo di colonna è impostata su false, la colonna non viene visualizzata nel GridView controllo e i dati per la colonna non effettuano un round trip al client. Se si desidera che i dati di una colonna non siano visibili per eseguire un round trip, aggiungere il nome del DataKeyNames campo alla proprietà .

Si applica a