Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
BoundColumn, classe
Type de colonne pour le contrôle DataGrid qui est lié à un champ dans une source de données.
Assembly : System.Web (dans System.Web.dll)
Le type BoundColumn expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
DataField | Obtient ou définit le nom du champ issu de la source de données à lier au BoundColumn. |
|
DataFormatString | Obtient ou définit la chaîne qui spécifie le format d'affichage des éléments contenus dans la colonne. |
|
DesignMode | Obtient une valeur indiquant si la colonne est en mode design. (Hérité de DataGridColumn.) |
|
FooterStyle | Obtient les propriétés de style pour la section de pied de page de la colonne. (Hérité de DataGridColumn.) |
|
FooterText | Obtient ou définit le texte affiché dans la section de pied de page de la colonne. (Hérité de DataGridColumn.) |
|
HeaderImageUrl | Obtient ou définit l'emplacement d'une image à afficher dans la section d'en-tête de la colonne. (Hérité de DataGridColumn.) |
|
HeaderStyle | Obtient les propriétés de style pour la section d'en-tête de la colonne. (Hérité de DataGridColumn.) |
|
HeaderText | Obtient ou définit le texte affiché dans la section d'en-tête de la colonne. (Hérité de DataGridColumn.) |
|
IsTrackingViewState | Obtient une valeur qui détermine si l'objet DataGridColumn est marqué pour enregistrer son état. (Hérité de DataGridColumn.) |
|
ItemStyle | Obtient les propriétés de style pour les cellules d'éléments de la colonne. (Hérité de DataGridColumn.) |
|
Owner | Obtient le contrôle DataGrid dont la colonne est membre. (Hérité de DataGridColumn.) |
|
ReadOnly | Obtient ou définit une valeur indiquant si les éléments du BoundColumn peuvent être modifiés. |
|
SortExpression | Obtient ou définit le nom du champ ou de l'expression à passer à la méthode OnSortCommand lorsqu'une colonne est sélectionnée pour être triée. (Hérité de DataGridColumn.) |
|
ViewState | Obtient l'objet System.Web.UI.StateBag qui permet à une colonne dérivée de la classe DataGridColumn de stocker ses propriétés. (Hérité de DataGridColumn.) |
|
Visible | Obtient ou définit une valeur qui indique si la colonne est visible dans le contrôle DataGrid. (Hérité de DataGridColumn.) |
| Nom | Description | |
|---|---|---|
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
FormatDataValue | Convertit la valeur spécifiée au format indiqué par la propriété DataFormatString. |
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
Initialize | Rétablit BoundColumn à son état initial. (Substitue DataGridColumn.Initialize().) |
|
InitializeCell | Rétablit l'état initial de la cellule spécifiée dans le BoundColumn. (Substitue DataGridColumn.InitializeCell(TableCell, Int32, ListItemType).) |
|
LoadViewState | Charge l'état de l'objet DataGridColumn. (Hérité de DataGridColumn.) |
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
OnColumnChanged | Appelle la méthode DataGridDesigner.OnColumnsChanged. (Hérité de DataGridColumn.) |
|
SaveViewState | Enregistre l'état actuel de l'objet DataGridColumn. (Hérité de DataGridColumn.) |
|
ToString | Retourne la représentation sous forme de chaîne de la colonne. (Hérité de DataGridColumn.) |
|
TrackViewState | Provoque le suivi des modifications de l'état d'affichage pour le contrôle serveur afin qu'elles puissent être stockées dans l'objet System.Web.UI.StateBag du contrôle serveur. (Hérité de DataGridColumn.) |
| Nom | Description | |
|---|---|---|
|
IStateManager.IsTrackingViewState | Infrastructure. Obtient une valeur qui indique si la colonne suit les changements de l'état d'affichage. (Hérité de DataGridColumn.) |
|
IStateManager.LoadViewState | Infrastructure. Charge l'état enregistré précédemment. (Hérité de DataGridColumn.) |
|
IStateManager.SaveViewState | Infrastructure. Retourne un objet contenant les modifications de l'état. (Hérité de DataGridColumn.) |
|
IStateManager.TrackViewState | Infrastructure. Commence à suivre les modifications d'état. (Hérité de DataGridColumn.) |
Utilisez le type de colonne BoundColumn dans un contrôle DataGrid pour afficher le contenu d'un champ de la source de données. Les valeurs sont répertoriées dans une seule colonne. Le champ est lié au BoundColumn, de sorte que toute mise à jour dans la source de données sera réfléchie dans les cellules correspondantes du contrôle DataGrid.
Remarque
|
|---|
|
Ce type de colonne est l'option par défaut pour le contrôle DataGrid. |
Pour définir l'apparence de cette colonne, utilisez les propriétés de style du contrôle DataGrid.
Attention
|
|---|
|
Le texte n'est pas encodé au format HTML avant d'être affiché dans BoundColumn. Il est ainsi possible d'incorporer du script dans les balises HTML dans le texte. Si les valeurs de cette colonne proviennent d'entrées d'utilisateur, assurez-vous de valider les valeurs pour réduire les problèmes de sécurité. |
L'exemple suivant montre comment utiliser un type de colonne BoundColumn dans le contrôle DataGrid pour afficher les champs dans une source de données.
<%@ Page Language="C#" AutoEventWireup="True" %> <%@ Import Namespace="System.Data" %> <!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" > <script language="C#" runat="server"> ICollection CreateDataSource() { DataTable dt = new DataTable(); DataRow dr; dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32))); dt.Columns.Add(new DataColumn("StringValue", typeof(string))); dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double))); for (int i = 0; i < 9; i++) { dr = dt.NewRow(); dr[0] = i; dr[1] = "Item " + i.ToString(); dr[2] = 1.23 * (i + 1); dt.Rows.Add(dr); } DataView dv = new DataView(dt); return dv; } void Page_Load(Object sender, EventArgs e) { if (!IsPostBack) { // Load this data only once. ItemsGrid.DataSource= CreateDataSource(); ItemsGrid.DataBind(); } } </script> <head runat="server"> <title>BoundColumn Example</title> </head> <body> <form id="form1" runat="server"> <h3>BoundColumn Example</h3> <b>Product List</b> <asp:DataGrid id="ItemsGrid" BorderColor="black" BorderWidth="1" CellPadding="3" AutoGenerateColumns="false" runat="server"> <HeaderStyle BackColor="#00aaaa"> </HeaderStyle> <Columns> <asp:BoundColumn HeaderText="Number" DataField="IntegerValue"> </asp:BoundColumn> <asp:BoundColumn HeaderText="Description" DataField="StringValue"> </asp:BoundColumn> <asp:BoundColumn HeaderText="Price" DataField="CurrencyValue" DataFormatString="{0:c}"> </asp:BoundColumn> </Columns> </asp:DataGrid> </form> </body> </html>
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Remarque
Attention