GridView.Columns Proprietà

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 una raccolta di DataControlField oggetti che rappresentano i campi di colonna in un GridView controllo .

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

Oggetto DataControlFieldCollection contenente tutti i campi di colonna nel GridView controllo .

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 rendering nel GridView controllo . È anche possibile utilizzare la Columns raccolta per gestire a livello di codice la raccolta di campi di colonna.

Annotazioni

I campi di colonna dichiarati in modo esplicito possono essere usati in combinazione con i campi di colonna generati automaticamente. Quando vengono usati entrambi, viene eseguito il rendering dei campi di colonna dichiarati in modo esplicito, seguiti dai campi colonna generati automaticamente. I campi 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 . Nella tabella seguente vengono illustrate 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 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 nel GridView controllo, in base a un modello specificato. Questo tipo di campo di 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 utilizzare la Visible proprietà di ogni campo di colonna per visualizzare o nascondere ogni campo di colonna.

Se la Visible proprietà di un campo 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 effettuare un round trip, aggiungere il nome del campo alla DataKeyNames proprietà .

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?