Colonnes, boîte de dialogue Propriétés de DataGrid
Mise à jour : novembre 2007
L'onglet Colonnes de la boîte de dialogue Propriétés de DataGrid vous permet d'effectuer les tâches suivantes :
spécifier les colonnes de données qui apparaissent dans la grille ;
attribuer à des colonnes des fonctions spéciales, par exemple la modification et la sélection d'éléments ;
définir des colonnes de modèle ;
spécifier des informations spécifiques à des colonnes individuelles, par exemple une expression de tri et un nom de commande ;
définir l'en-tête et le pied de page, le contenu et la liaison de données pour chaque colonne de la grille.
Après avoir défini une colonne, vous pouvez préciser ses propriétés. Les options disponibles dans l'onglet Colonnes varient en fonction du type de colonne DataGrid que vous utilisez.
.gif "Remarque") Remarque : |
|---|
La version 2.0 d'ASP.NET est fournie avec un nouveau contrôle serveur, GridView, proposant davantage de fonctionnalités que le contrôle DataGrid. Pour plus d'informations, consultez Comparaison des contrôles serveur Web GridView et DataGrid. |
Pour accéder à cette boîte de dialogue
Dans Microsoft Visual Web Developer, ouvrez ou créez une page .aspx.
En mode Source, ajoutez un contrôle DataGrid à la page dans l'élément <form>. Votre code peut se présenter de la manière suivante :
<form id="form1" > <div> <asp:DataGrid ID="DataGrid1" ></asp:DataGrid> </div> </form>Basculez en mode Design.
Cliquez avec le bouton droit sur le contrôle DataGrid, puis cliquez sur Afficher la balise active.
La fenêtre Tâches DataGrid s'ouvre.
Cliquez sur Générateur de propriétés.
La boîte de dialogue Propriétés de DataGrid s'ouvre.
Cliquez sur l'onglet Colonnes.
Tâches
Éléments d'interface
Créer des colonnes automatiquement au moment de l'exécution
Spécifie si la grille, au moment de l'exécution, inclut tous les champs de données de la source de données à laquelle elle est liée. Vous ne pouvez ni supprimer, ni mettre en forme ces colonnes.Vous pouvez ajouter des colonnes, en particulier des colonnes liées aux données et des colonnes de bouton, de lien hypertexte et de modèle, conformément à la description figurant ci-dessous dans la « Liste des colonnes ». Toutes les colonnes que vous ajoutez apparaissent à gauche des colonnes générées automatiquement.
Liste des colonnes
La liste de colonnes vous permet de spécifier les colonnes qui apparaissent dans la grille. Vous pouvez ajouter des champs de la source de données et divers types de boutons.
Pour ajouter une colonne, sélectionnez son type sous Colonnes disponibles, puis cliquez sur le bouton Ajouter pour l'ajouter à la liste Colonnes sélectionnées. Pour spécifier l'emplacement de la colonne dans la grille, sélectionnez-la dans la liste Colonnes sélectionnées, puis utilisez les boutons de réorganisation pour la déplacer. Pour supprimer une colonne de la grille, sélectionnez-la dans la liste Colonnes sélectionnées, puis cliquez sur le bouton Supprimer.
Colonnes disponibles
Répertorie toutes les colonnes que la grille peut afficher, en les regroupant dans les nœuds suivants :Colonne dépendante Utilisez ce nœud pour ajouter des colonnes de données individuelles, choisies parmi celles qui sont disponibles dans la source de données sélectionnée sous l'onglet Général.
Si l'option Créer des colonnes automatiquement au moment de l'exécution est activée, toutes les colonnes de ce nœud sont affichées. Pour n'afficher que certaines colonnes, désactivez l'option Créer des colonnes automatiquement au moment de l'exécution et ajoutez les champs de données que vous voulez utiliser.
Colonne de boutons Utilisez ce type pour ajouter des colonnes contenant des boutons (boutons de commande ou boutons de lien) sur lesquels l'utilisateur pourra cliquer afin d'effectuer des actions spécifiques pour un élément individuel. Ouvrez le nœud Colonne de boutons pour ajouter des boutons Sélectionner, Supprimer ou Modifier à la grille. Pour ajouter un bouton personnalisé (par exemple un bouton intitulé « Mettre dans le panier d'achat »), sélectionnez le nœud Colonne de boutons, cliquez sur le bouton Ajouter, puis mettez en forme le bouton personnalisé.
Colonne de lien hypertexte Utilisez ce type pour ajouter une colonne contenant un lien à une autre page. La colonne de lien hypertexte peut contenir un texte statique ou afficher une colonne de données sous forme de lien hypertexte.
Colonne de modèle Utilisez ce type pour créer une colonne contenant une combinaison quelconque de texte HTML et de contrôles. Les colonnes de modèle vous permettent d'inclure des contrôles autres que des boutons (par exemple des cases à cocher) dans un contrôle DataGrid.
Colonnes sélectionnées
Affiche une liste de colonnes que vous pouvez personnaliser. Lorsque vous sélectionnez une colonne dans cette liste, les options affichées au-dessous dans la boîte de dialogue changent afin de refléter les paramètres que vous pouvez personnaliser pour cette colonne.Si Créer des colonnes automatiquement au moment de l'exécution est sélectionné, Colonnes sélectionnées affiche une liste des colonnes qui apparaîtront en plus des colonnes générées automatiquement.
Propriétés des colonnes
Texte de l'en-tête
Texte affiché en haut de la colonne. Cette propriété accepte n'importe quel texte HTML (avec des balises) comme valeur. Vous pouvez définir la police et la couleur du texte de l'en-tête sous l'onglet Format.Le texte que vous spécifiez pour l'en-tête devient l'identificateur de la colonne dans la liste Colonnes sélectionnées.
Les en-têtes ne s'affichent que si la case à cocher Afficher l'en-tête est activée dans l'onglet Général.
Texte du pied de page
Texte affiché en bas de la colonne. Par défaut, cette propriété est vide. Elle accepte n'importe quel texte HTML (avec des balises) comme valeur. Vous pouvez définir la police et la couleur du texte de l'en-tête sous l'onglet Format.Les pieds de page ne s'affichent que si la case à cocher Afficher le pied de page est activée dans l'onglet Général.
Image d'en-tête
URL d'un fichier image qui est affiché en haut de la colonne. Si vous spécifiez un texte et une image d'en-tête, l'image a priorité.Expression de tri
Chaîne passée en tant que paramètre lorsque l'événement SortCommand est déclenché. Si vous avez activé la case à cocher Autoriser le tri sous l'onglet Général, les en-têtes de colonnes se présentent sous forme de contrôles LinkButton qui déclenchent l'événement SortCommand lorsque l'utilisateur clique dessus.Pour une colonne dépendante, l'expression de tri par défaut est le nom du champ de données auquel la colonne est liée. Vous pouvez toutefois spécifier n'importe quelle chaîne.
Visible
Détermine si la colonne est visible par défaut lorsque la page s'exécute. Désactiver cette case à cocher vous permet de définir une colonne et de spécifier ses informations de liaison et de mise en forme, puis de l'afficher et de la masquer dynamiquement au moment de l'exécution.
Propriétés de BoundColumn
Les options figurant sous Propriétés de BoundColumn s'affichent si vous sélectionnez Colonne dépendante dans Colonnes disponibles et si vous cliquez sur le bouton flèche pour la déplacer dans Colonnes sélectionnées.
Champ de données
Nom du champ de données auquel cette colonne est liée. Propriété en lecture seule.Expression de mise en forme des données
Expression de mise en forme .NET Framework appliquée aux données avant leur affichage dans la colonne. L'expression se compose d'un texte statique facultatif et d'un spécificateur de format qui a la forme suivante :{0:format specifier}Le numéro précédant les deux points (:) est un index de paramètre indiquant quels éléments de données de la colonne doivent être mis en forme. Cet index a généralement pour valeur zéro afin d'indiquer le premier (et unique) élément. Le spécificateur de format est situé derrière les deux-points et se compose d'une ou de plusieurs lettres qui indiquent comment mettre en forme les données. Les caractères de spécificateur de format que vous pouvez utiliser dépendent du type de données mises en formes (dates, nombres ou autres). Le tableau ci-dessous donne des exemples d'expressions de mise en forme pour différents types de données. Pour plus d'informations sur les expressions de mise en forme, consultez Mise en forme des types.
Expression de mise en forme
Appliquée à ce type de données
Description
Prix : {0:C}
numériques, décimales
Affiche la chaîne littérale "Prix :" suivie de nombres au format monétaire. Le format monétaire dépend du paramètre de culture spécifié par le biais de l'attribut culture sur la directive @ Page ou dans le fichier Web.config.
{0:D4}
entier (ne peut pas être utilisée avec des nombres décimaux.)
Les entiers sont affichés dans un champ de quatre caractères rempli de zéros.
{0:N2} %
numériques
Affiche le nombre avec une précision de 2 décimales, suivi de la chaîne littérale "%".
{0:000.0}
numériques, décimales
Nombre arrondis à un chiffre après la virgule. Les nombres de moins de trois chiffres sont remplis de zéros.
{0:D}
date/datetime
Format de date longue (« Jeudi 06 août 1996 »). Le format de date dépend des paramètres de culture de la page ou du fichier Web.config.
{0:d}
date/datetime
Format de date courte (« 31/12/99 »).
{0:aa-MM-jj}
date/datetime
Date au format numérique année-mois-jour (96-08-06).
En lecture seule
Indique si les données de cette colonne sont affichées dans un contrôle modifiable lorsque l'élément est placé en mode édition.
Propriétés de ButtonColumn
Les options figurant sous Propriétés de ButtonColumn s'affichent si vous sélectionnez Colonne de boutons dans Colonnes disponibles et si vous cliquez sur le bouton flèche pour la déplacer dans Colonnes sélectionnées.
Texte
Texte (légende) des boutons s'ils ont le même texte pour tous les éléments de la grille. Par exemple, spécifiez la valeur de la propriété Texte si vous définissez un bouton qui affiche le mot « Sélectionner » pour tous les éléments de la grille. Si la propriété Champ de texte est définie, elle se substitue à cette propriété.Nom de la commande
Chaîne passée avec l'événement ItemCommand lorsque les utilisateurs cliquent sur le bouton.Champ de texte
Champ de la source de données à utiliser comme source de la légende du bouton. Si vous définissez cette propriété et la propriété Texte, la propriété Champ de texte est prioritaire.Type de bouton
Type de bouton à représenter — Bouton lien ou Bouton de commande. Il s'agit par défaut d'un contrôle Bouton lien.Chaîne de format de texte
Une expression de mise en forme .NET Framework qui est appliquée à la légende du bouton avant son affichage. Cette propriété s'avère utile si vous utilisez la propriété Champ de texte pour définir la légende du bouton alors que les données ne se présentent pas sous une forme appropriée à l'affichage. Pour plus d'informations, consultez « Propriétés de BoundColumn », ci-dessus.
Propriétés d'EditCommandColumn
Les options figurant sous Propriétés d'EditButtonColumn s'affichent si l'élément sélectionné dans Colonnes sélectionnées est une colonne de boutons Modifier.
Modifier le texte
Chaîne à afficher sur le bouton Modifier.Annuler le texte
Chaîne à afficher sur le bouton Annuler.Mettre à jour le texte
Chaîne à afficher sur le bouton Mettre à jour.Type de bouton
Type de bouton à représenter — Bouton lien ou Bouton de commande. Il s'agit par défaut d'un contrôle Bouton lien.
Propriétés de HyperLinkColumn
Les options figurant sous Propriétés de HyperLinkColumn s'affichent si vous sélectionnez Colonne de lien hypertexte dans Colonnes disponibles et si vous cliquez sur le bouton flèche pour la déplacer dans Colonnes sélectionnées.
Texte
Texte du lien hypertexte si les liens ont le même texte pour tous les éléments de la grille.URL
URL de la page à atteindre. Si la propriété Champ URL est définie, elle se substitue à cette propriété.Champ de texte
Champ de la source de données à utiliser comme source du texte du lien hypertexte.Champ URL
Champ ou propriété de l'objet de la DataSource qui fournira l'URL de la page à atteindre. Cette propriété substitue la propriété URL.Chaîne de format de texte
Spécificateur de mise en forme .NET Framework qui est appliqué au lien hypertexte avant son affichage. Cette propriété s'avère utile si vous utilisez la propriété Champ de texte pour définir le texte du lien hypertexte alors que les données ne se présentent pas sous une forme appropriée à l'affichage. Pour plus d'informations, consultez « Propriétés de BoundColumn » ci-dessus.Chaîne de format de l'URL
Expression qui définit la mise en forme de l'URL. Cette expression peut inclure une expression de mise en forme .NET Framework. Par exemple, vous pouvez utiliser un format d'URL comme le suivant :images/Title-{0}.gifCe format est susceptible de produire une URL présentant l'aspect suivant :
images/Title-1.gifPour plus d'informations, consultez « Propriétés de BoundColumn » ci-dessus.
Cible
Fenêtre dans laquelle cette colonne de boutons doit être affichée. Saisissez le nom d'une fenêtre qui existera au moment de l'exécution ou sélectionnez la fenêtre dans la liste prédéfinie des identificateurs de fenêtre standard.Convertit cette colonne en colonne modèle
Recrée la colonne sélectionnée pour utiliser comme modèle, qui est une combinaison de texte HTML et de contrôles. Cela vous permet de spécifier précisément l'apparence de la colonne.