Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout

BoundField, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Représente un champ qui s'affiche sous forme de texte dans un contrôle lié aux données.

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

public class BoundField : DataControlField
public class BoundField extends DataControlField
public class BoundField extends DataControlField

La classe BoundField est utilisée par les contrôles liés aux données (tels que GridView et DetailsView) pour afficher la valeur d'un champ sous forme de texte. L'affichage de l'objet BoundField varie en fonction du contrôle lié aux données dans lequel il est utilisé. Par exemple, le contrôle GridView affiche un objet BoundField sous forme de une colonne, tandis que le contrôle DetailsView l'affiche sous forme de ligne.

Pour spécifier le champ à afficher dans un objet BoundField, affectez le nom du champ à la propriété DataField. La valeur du champ peut être codée en HTML avant qu'il soit affiché en affectant true à la propriété HtmlEncode. Vous pouvez appliquer une chaîne de mise en forme personnalisée à la valeur du champ en définissant la propriété DataFormatString. Lorsque la propriété HtmlEncode a la valeur true, la valeur de chaîne codée du champ est utilisée dans la chaîne de mise en forme personnalisée. Par défaut, la chaîne de mise en forme est appliquée aux valeurs de champ uniquement lorsque le contrôle lié aux données est en lecture seule. Pour appliquer la chaîne de mise en forme aux valeurs affichées lorsque le contrôle lié aux données est en mode édition, affectez true à la propriété ApplyFormatInEditMode. Si la valeur d'un champ est null, vous pouvez afficher une légende personnalisée en définissant la propriété NullDisplayText. L'objet BoundField peut également convertir automatiquement des valeurs de champ de chaîne vide ("") en valeurs null en affectant true à la propriété ConvertEmptyStringToNull.

Vous pouvez masquer un objet BoundField dans un contrôle lié aux données en affectant false à la propriété Visible. Pour empêcher la valeur d'un champ d'être modifié en mode édition, affectez true à la propriété ReadOnly. Dans les contrôles liés aux données qui prennent en charge l'insertion d'enregistrements (tels que le contrôle DetailsView), vous pouvez masquer un objet BoundField en affectant false à la propriété InsertVisible. Cette technique est généralement utilisée lorsque vous souhaitez masquer un champ clé généré automatiquement en mode insertion.

Vous pouvez personnaliser les sections d'en-tête et de pied de page d'un objet BoundField. Pour afficher une légende dans les sections d'en-tête ou de pied de page, définissez les propriétés HeaderText ou FooterText, respectivement. Au lieu d'afficher du texte dans la section d'en-tête, vous pouvez afficher une image en définissant la propriété HeaderImageUrl. La section d'en-tête peut être masquée dans l'objet BoundField en affectant false à la propriété ShowHeader.

RemarqueRemarque

Certains contrôles liés aux données (tels que le contrôle GridView) peuvent uniquement afficher ou masquer l'intégralité de la section d'en-tête du contrôle. Ces contrôles liés aux données ne prennent pas en charge la propriété ShowHeader pour un champ lié. Pour afficher ou masquer l'intégralité de la section d'en-tête d'un contrôle lié aux données (le cas échéant), utilisez la propriété ShowHeader du contrôle.

Vous pouvez également personnaliser l'apparence de l'objet BoundField (couleur de police, couleur d'arrière-plan, etc.) en définissant les propriétés de style des différentes parties du champ. Le tableau suivant énumère les différentes propriétés de style.

Propriété du style

Description

ControlStyle

Paramètres de style pour les contrôles serveur Web enfants de l'objet BoundField.

FooterStyle

Paramètres de style de la section de pied de page de l'objet BoundField.

HeaderStyle

Paramètres de style de la section d'en-tête de l'objet BoundField.

ItemStyle

Paramètres de style des éléments de données dans l'objet BoundField.

L'exemple de code suivant montre comment utiliser un objet BoundField pour afficher les valeurs d'un champ dans un contrôle GridView.


<%@ Page language="C#" %>

<html>
  <body>
    <form runat="server">
        
      <h3>BoundField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </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

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft