BoundColumn Classe

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.

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

public ref class BoundColumn : System::Web::UI::WebControls::DataGridColumn

public class BoundColumn : System.Web.UI.WebControls.DataGridColumn

type BoundColumn = class
    inherit DataGridColumn

Public Class BoundColumn
Inherits DataGridColumn

Héritage: Object

DataGridColumn
BoundColumn

Exemples

L’exemple suivant montre comment utiliser un BoundColumn type de colonne dans le DataGrid contrôle pour afficher les champs d’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>

<%@ Page Language="VB" 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="VB" runat="server">
    Function CreateDataSource() As ICollection
        Dim dt As New DataTable()
        Dim dr As DataRow
        
        dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
        dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
        dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
        
        Dim i As Integer
        For i = 0 To 8
            dr = dt.NewRow()
            
            dr(0) = i
            dr(1) = "Item " + i.ToString()
            dr(2) = 1.23 *(i + 1)
            
            dt.Rows.Add(dr)
        Next i
        
        Dim dv As New DataView(dt)
        Return dv
    End Function 'CreateDataSource


    Sub Page_Load(sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            ' Load this data only once.
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()
        End If
    End Sub 'Page_Load
   </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>

Remarques

Utilisez le BoundColumn type de colonne dans un DataGrid contrôle pour afficher le contenu d’un champ dans la source de données. Les valeurs sont répertoriées dans une seule colonne. Le champ est lié au BoundColumnchamp , de sorte que toutes les mises à jour de la source de données se reflètent dans les cellules correspondantes du DataGrid contrôle.

Notes

Ce type de colonne est la valeur par défaut du DataGrid contrôle.

Pour contrôler l’apparence de cette colonne, utilisez les propriétés de style du DataGrid contrôle.

Attention

Le texte n’est pas encodé au format HTML avant qu’il ne soit affiché dans le BoundColumn. Cela permet d’incorporer un script dans des balises HTML dans le texte. Si les valeurs de cette colonne proviennent de l’entrée utilisateur, veillez à valider les valeurs pour réduire les vulnérabilités de sécurité.

Constructeurs

BoundColumn()

Initialise une nouvelle instance de la classe BoundColumn.

Champs

thisExpr

Représente la chaîne « ! ». Ce champ est en lecture seule.

Propriétés

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(DataGridSortCommandEventArgs) lorsqu'une colonne est sélectionnée pour être triée. (Hérité de DataGridColumn)
ViewState	Obtient l'objet 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)

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FormatDataValue(Object)	Convertit la valeur spécifiée au format indiqué par la propriété DataFormatString.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Initialize()	Rétablit BoundColumn à son état initial.
InitializeCell(TableCell, Int32, ListItemType)	Rétablit l'état initial de la cellule spécifiée dans le BoundColumn.
LoadViewState(Object)	Charge l'état de l'objet DataGridColumn. (Hérité de DataGridColumn)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnColumnChanged()	Appelle la méthode 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 StateBag du contrôle serveur. (Hérité de DataGridColumn)

Implémentations d’interfaces explicites

IStateManager.IsTrackingViewState	Obtient une valeur qui indique si la colonne suit les changements de l'état d'affichage. (Hérité de DataGridColumn)
IStateManager.LoadViewState(Object)	Charge l'état enregistré précédemment. (Hérité de DataGridColumn)
IStateManager.SaveViewState()	Retourne un objet contenant les modifications de l'état. (Hérité de DataGridColumn)
IStateManager.TrackViewState()	Commence à suivre les modifications d'état. (Hérité de DataGridColumn)

S’applique à