GridView.Columns Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient une collection d'objets DataControlField qui représentent les champs de colonnes du contrôle 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

Valeur de propriété

DataControlFieldCollection

DataControlFieldCollection qui contient tous les champs de colonnes du contrôle GridView.

Attributs: PersistenceModeAttribute

Exemples

L’exemple suivant montre comment remplir la Columns collection de manière déclarative.


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

Remarques

Un champ de colonne représente une colonne dans un GridView contrôle. La Columns propriété (collection) est utilisée pour stocker tous les champs de colonne déclarés explicitement qui sont rendus dans le GridView contrôle. Vous pouvez également utiliser la Columns collection pour gérer par programmation la collection de champs de colonne.

Notes

Les champs de colonne déclarés explicitement peuvent être utilisés en combinaison avec des champs de colonne générés automatiquement. Lorsque les deux sont utilisés, les champs de colonne déclarés explicitement sont affichés en premier, suivis des champs de colonne générés automatiquement. Les champs de colonne générés automatiquement ne sont pas ajoutés à la Columns collection.

Les champs de colonne sont affichés dans le GridView contrôle dans l’ordre dans lequel les champs de colonne apparaissent dans la Columns collection. Le tableau suivant montre les différentes classes de champ de colonne qui dérivent de la DataControlField classe et peuvent être utilisées dans la Columns collection.

Type de champ de colonne	Description
BoundField	Affiche la valeur d’un champ dans une source de données. Il s’agit du type de colonne par défaut du GridView contrôle.
ButtonField	Affiche un bouton de commande pour chaque élément du GridView contrôle. Cela vous permet de créer une colonne de contrôles de bouton personnalisés, tels que le bouton Ajouter ou Supprimer.
CheckBoxField	Affiche une case à cocher pour chaque élément du GridView contrôle. Ce type de champ de colonne est couramment utilisé pour afficher des champs avec une valeur booléenne.
CommandField	Affiche des boutons de commande prédéfinis pour effectuer des opérations de sélection, de modification ou de suppression.
HyperLinkField	Affiche la valeur d’un champ dans une source de données sous forme de lien hypertexte. Ce type de champ de colonne vous permet de lier un deuxième champ à l’URL du lien hypertexte.
ImageField	Affiche une image pour chaque élément du GridView contrôle.
TemplateField	Affiche le contenu défini par l’utilisateur pour chaque élément du GridView contrôle, en fonction d’un modèle spécifié. Ce type de champ de colonne vous permet de créer un champ de colonne personnalisé.

Bien que vous puissiez ajouter par programmation des champs de colonne à la Columns collection, il est plus facile de répertorier les champs de colonne de manière déclarative dans le GridView contrôle, puis d’utiliser la Visible propriété de chaque champ de colonne pour afficher ou masquer chaque champ de colonne.

Si la Visible propriété d’un champ de colonne est définie falsesur , la colonne n’est pas affichée dans le GridView contrôle et les données de la colonne n’effectuent pas d’aller-retour au client. Si vous souhaitez que les données d’une colonne qui ne soit pas visible pour effectuer un aller-retour, ajoutez le nom du champ à la DataKeyNames propriété.

S’applique à