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
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

BoundColumn, classe

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

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

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)
public class BoundColumn : DataGridColumn

Le type BoundColumn expose les membres suivants.

  Nom Description
Méthode publique BoundColumn Initialise une nouvelle instance de la classe BoundColumn.
Début
  Nom Description
Propriété publique DataField Obtient ou définit le nom du champ issu de la source de données à lier au BoundColumn.
Propriété publique DataFormatString Obtient ou définit la chaîne qui spécifie le format d'affichage des éléments contenus dans la colonne.
Propriété protégée DesignMode Obtient une valeur indiquant si la colonne est en mode design. (Hérité de DataGridColumn.)
Propriété publique FooterStyle Obtient les propriétés de style pour la section de pied de page de la colonne. (Hérité de DataGridColumn.)
Propriété publique FooterText Obtient ou définit le texte affiché dans la section de pied de page de la colonne. (Hérité de DataGridColumn.)
Propriété publique 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.)
Propriété publique HeaderStyle Obtient les propriétés de style pour la section d'en-tête de la colonne. (Hérité de DataGridColumn.)
Propriété publique HeaderText Obtient ou définit le texte affiché dans la section d'en-tête de la colonne. (Hérité de DataGridColumn.)
Propriété protégée IsTrackingViewState Obtient une valeur qui détermine si l'objet DataGridColumn est marqué pour enregistrer son état. (Hérité de DataGridColumn.)
Propriété publique ItemStyle Obtient les propriétés de style pour les cellules d'éléments de la colonne. (Hérité de DataGridColumn.)
Propriété protégée Owner Obtient le contrôle DataGrid dont la colonne est membre. (Hérité de DataGridColumn.)
Propriété publique ReadOnly Obtient ou définit une valeur indiquant si les éléments du BoundColumn peuvent être modifiés.
Propriété publique 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.)
Propriété protégée 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.)
Propriété publique Visible Obtient ou définit une valeur qui indique si la colonne est visible dans le contrôle DataGrid. (Hérité de DataGridColumn.)
Début
  Nom Description
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode protégée 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.)
Méthode protégée FormatDataValue Convertit la valeur spécifiée au format indiqué par la propriété DataFormatString.
Méthode publique GetHashCode Sert de fonction de hachage pour un type particulier. (Hérité de Object.)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique Initialize Rétablit BoundColumn à son état initial. (Substitue DataGridColumn.Initialize().)
Méthode publique InitializeCell Rétablit l'état initial de la cellule spécifiée dans le BoundColumn. (Substitue DataGridColumn.InitializeCell(TableCell, Int32, ListItemType).)
Méthode protégée LoadViewState Charge l'état de l'objet DataGridColumn. (Hérité de DataGridColumn.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégée OnColumnChanged Appelle la méthode DataGridDesigner.OnColumnsChanged. (Hérité de DataGridColumn.)
Méthode protégée SaveViewState Enregistre l'état actuel de l'objet DataGridColumn. (Hérité de DataGridColumn.)
Méthode publique ToString Retourne la représentation sous forme de chaîne de la colonne. (Hérité de DataGridColumn.)
Méthode protégée 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.)
Début
  Nom Description
Champ public Membre statique thisExpr Représente la chaîne « ! ». Ce champ est en lecture seule.
Début
  Nom Description
Implémentation d'interface explicite Propriété privée IStateManager.IsTrackingViewState Infrastructure. Obtient une valeur qui indique si la colonne suit les changements de l'état d'affichage. (Hérité de DataGridColumn.)
Implémentation d'interface explicite Méthode privée IStateManager.LoadViewState Infrastructure. Charge l'état enregistré précédemment. (Hérité de DataGridColumn.)
Implémentation d'interface explicite Méthode privée IStateManager.SaveViewState Infrastructure. Retourne un objet contenant les modifications de l'état. (Hérité de DataGridColumn.)
Implémentation d'interface explicite Méthode privée IStateManager.TrackViewState Infrastructure. Commence à suivre les modifications d'état. (Hérité de DataGridColumn.)
Début

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

Remarque Attention 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>



.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

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.
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ