GridView.Columns Property

Definition

Ottiene un insieme di oggetti DataControlField che rappresentano i campi colonna in un controllo GridView.Gets a collection of DataControlField objects that represent the column fields in a GridView control.

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; }
member this.Columns : System.Web.UI.WebControls.DataControlFieldCollection
Public Overridable ReadOnly Property Columns As DataControlFieldCollection

Property Value

DataControlFieldCollection

Un oggetto DataControlFieldCollection contenente tutti i campi colonna all'interno del controllo GridView.A DataControlFieldCollection that contains all the column fields in the GridView control.

Attributes

Examples

Nell'esempio seguente viene illustrato come popolare il Columns raccolta in modo dichiarativo.The following example demonstrates how to populate the Columns collection declaratively.


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

Remarks

Un campo colonna rappresenta una colonna in un controllo GridView.A column field represents a column in a GridView control. La proprietà Columns (Collection) viene utilizzata per archiviare tutti i campi di colonna dichiarati in modo esplicito di cui viene eseguito il rendering nel controllo GridView.The Columns property (collection) is used to store all the explicitly declared column fields that get rendered in the GridView control. È anche possibile usare la raccolta Columns per gestire a livello di codice la raccolta di campi colonna.You can also use the Columns collection to programmatically manage the collection of column fields.

Note

I campi colonna dichiarati in modo esplicito possono essere utilizzati in combinazione con i campi colonna generati automaticamente.Explicitly declared column fields can be used in combination with automatically generated column fields. Quando vengono utilizzati entrambi, viene eseguito prima il rendering dei campi di colonna dichiarati in modo esplicito, seguiti dai campi colonna generati automaticamente.When both are used, explicitly declared column fields are rendered first, followed by the automatically generated column fields. I campi colonna generati automaticamente non vengono aggiunti alla raccolta Columns.Automatically generated column fields are not added to the Columns collection.

I campi colonna vengono visualizzati nel controllo GridView nell'ordine in cui i campi della colonna vengono visualizzati nella raccolta di Columns.The column fields are displayed in the GridView control in the order that the column fields appear in the Columns collection. Nella tabella seguente vengono illustrate le diverse classi di campo della colonna che derivano dalla classe DataControlField e che possono essere utilizzate nella raccolta Columns.The following table shows the different column field classes that derive from the DataControlField class and can be used in the Columns collection.

Tipo di campo colonnaColumn field type DescrizioneDescription
BoundField Consente di visualizzare il valore di un campo in un'origine dati.Displays the value of a field in a data source. Si tratta del tipo di colonna predefinito del controllo GridView.This is the default column type of the GridView control.
ButtonField Visualizza un pulsante di comando per ogni elemento nel controllo GridView.Displays a command button for each item in the GridView control. Ciò consente di creare una colonna di controlli Button personalizzati, ad esempio il pulsante Aggiungi o Rimuovi.This enables you to create a column of custom button controls, such as the Add or the Remove button.
CheckBoxField Visualizza una casella di controllo per ogni elemento nel controllo GridView.Displays a check box for each item in the GridView control. Questo tipo di campo di colonna viene comunemente usato per visualizzare i campi con un valore booleano.This column field type is commonly used to display fields with a Boolean value.
CommandField Visualizza i pulsanti di comando predefiniti per eseguire operazioni SELECT, Edit o DELETE.Displays predefined command buttons to perform select, edit, or delete operations.
HyperLinkField Visualizza il valore di un campo in un'origine dati come collegamento ipertestuale.Displays the value of a field in a data source as a hyperlink. Questo tipo di campo colonna consente di associare un secondo campo all'URL del collegamento ipertestuale.This column field type enables you to bind a second field to the hyperlink's URL.
ImageField Visualizza un'immagine per ogni elemento nel controllo GridView.Displays an image for each item in the GridView control.
TemplateField Visualizza il contenuto definito dall'utente per ogni elemento nel controllo GridView, in base a un modello specificato.Displays user-defined content for each item in the GridView control, according to a specified template. Questo tipo di campo colonna consente di creare un campo colonna personalizzato.This column field type enables you to create a custom column field.

Sebbene sia possibile aggiungere campi colonna a livello di codice alla raccolta di Columns, è più semplice elencare in modo dichiarativo i campi colonna nel controllo GridView e quindi utilizzare la proprietà Visible di ogni campo colonna per mostrare o nascondere ogni campo colonna.Although you can programmatically add column fields to the Columns collection, it is easier to list the column fields declaratively in the GridView control and then use the Visible property of each column field to show or hide each column field.

Se la proprietà Visible di un campo colonna è impostata su false, la colonna non viene visualizzata nel controllo GridView e i dati per la colonna non costituiscono un round trip per il client.If the Visible property of a column field is set to false, the column is not displayed in the GridView control and the data for the column does not make a round trip to the client. Se si desidera che i dati di una colonna non visibile rendano un round trip, aggiungere il nome del campo alla proprietà DataKeyNames.If you want the data for a column that is not visible to make a round trip, add the field name to the DataKeyNames property.

Applies to

See also