Cette documentation est archivée et n’est pas conservée.

BoundColumn, classe

Type de colonne pour le contrôle DataGrid qui est lié à un champ dans une source de données.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public class BoundColumn : DataGridColumn
public class BoundColumn extends DataGridColumn
public class BoundColumn extends 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.

RemarqueRemarque

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.

AttentionAttention

Le texte n'est pas codé au format HTML avant d'être affiché dans BoundColumn. Il est ainsi possible d'incorporer un script dans des 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" %>
 
<html>
   <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>
 
<body>
 
   <form 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>


  • AspNetHostingPermission  Pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  Pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

System.Object
   System.Web.UI.WebControls.DataGridColumn
    System.Web.UI.WebControls.BoundColumn

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: