Partager via


BoundColumn Classe

Définition

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
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 à

Voir aussi