GridView.Columns GridView.Columns GridView.Columns GridView.Columns Property

Definizione

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

Valore della proprietà

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.

Esempi

Nell'esempio seguente viene illustrato come popolare la 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>

Commenti

Un campo colonna rappresenta una colonna in un GridView controllo.A column field represents a column in a GridView control. La Columns proprietà (Collection) viene utilizzata per archiviare tutti i campi di colonna dichiarati in modo esplicito GridView di cui viene eseguito il rendering nel controllo.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 Columns raccolta 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.

Nota

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 Columns campi colonna generati automaticamente non vengono aggiunti alla raccolta.Automatically generated column fields are not added to the Columns collection.

I campi colonna vengono visualizzati nel GridView controllo nell'ordine in cui i campi della colonna vengono visualizzati Columns nella raccolta.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 DataControlField derivano dalla classe e che Columns possono essere utilizzate nella raccolta.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 DescriptionDescription
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 GridView controllo.This is the default column type of the GridView control.
ButtonField Visualizza un pulsante di comando per ogni elemento nel GridView controllo.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 GridView controllo.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 GridView controllo.Displays an image for each item in the GridView control.
TemplateField Visualizza il GridView contenuto definito dall'utente per ogni elemento nel controllo 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 Columns alla raccolta, è più semplice elencare GridView in modo dichiarativo i campi colonna nel controllo e Visible quindi utilizzare la proprietà 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 Visible proprietà di un campo colonna è impostata su false, la colonna non GridView viene visualizzata nel controllo e i dati per la colonna non costituiscono un round trip al 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 DataKeyNames proprietà.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.

Si applica a

Vedi anche