Accueil Library Formation Téléchargements Support technique Communauté
Connexion | United States - English | |
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

BoundField, classe

.NET Framework 4

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

System.Object
  System.Web.UI.WebControls.DataControlField
    System.Web.UI.WebControls.BoundField
      System.Web.UI.WebControls.AutoGeneratedField
      System.Web.UI.WebControls.CheckBoxField

Espace de noms :  System.Web.UI.WebControls
Assembly :  System.Web (dans System.Web.dll)
C#
C++
F#
VB
Copier 
public class BoundField : DataControlField

Le type BoundField expose les membres suivants.

  Nom Description
Méthode publique BoundField Initialise une nouvelle instance de la classe BoundField.
Début
  Nom Description
Propriété publique AccessibleHeaderText Obtient ou définit le texte restitué sous forme de valeur de propriété AbbreviatedText dans certains contrôles. (Hérité de DataControlField.)
Propriété publique ApplyFormatInEditMode Obtient ou définit une valeur indiquant si la chaîne de mise en forme spécifiée par la propriété DataFormatString s'applique aux valeurs de champ lorsque le contrôle lié aux données qui contient l'objet BoundField est en mode édition.
Propriété protégée Control Obtient une référence au contrôle de données auquel l'objet DataControlField est associé. (Hérité de DataControlField.)
Propriété publique ControlStyle Obtient le style de tout contrôle serveur Web contenu dans l'objet DataControlField. (Hérité de DataControlField.)
Propriété publique ConvertEmptyStringToNull Obtient ou définit une valeur qui indique si les chaînes vides ("") sont converties automatiquement en valeurs null lorsque le champ de données est mis à jour dans la source de données.
Propriété publique DataField Obtient ou définit le nom du champ de données lié à lier à l'objet BoundField.
Propriété publique DataFormatString Obtient ou définit la chaîne qui spécifie le format d'affichage de la valeur du champ.
Propriété protégée DesignMode Obtient une valeur indiquant si un champ de contrôle de données est actuellement affiché dans un environnement au moment du design. (Hérité de DataControlField.)
Propriété publique FooterStyle Obtient ou définit le style du pied de page du champ de contrôle de données. (Hérité de DataControlField.)
Propriété publique FooterText Obtient ou définit le texte affiché dans l'élément de pied de page d'un champ de contrôle de données. (Hérité de DataControlField.)
Propriété publique HeaderImageUrl Obtient ou définit l'URL d'une image affichée dans l'élément d'en-tête d'un champ de contrôle de données. (Hérité de DataControlField.)
Propriété publique HeaderStyle Obtient ou définit le style de l'en-tête du champ de contrôle de données. (Hérité de DataControlField.)
Propriété publique HeaderText Obtient ou définit le texte qui s'affiche dans l'en-tête d'un contrôle de données. (Substitue DataControlField.HeaderText.)
Propriété publique HtmlEncode Obtient ou définit une valeur indiquant si les valeurs de champ sont encodées en HTML avant qu'elles soient affichées dans un objet BoundField.
Propriété publique HtmlEncodeFormatString Obtient ou définit une valeur qui indique si le texte créé en appliquant la propriété DataFormatString à la valeur BoundField doit être encodé en HTML lorsqu'il est affiché.
Propriété publique InsertVisible Obtient une valeur indiquant si l'objet DataControlField est visible lorsque son contrôle lié aux données parent est en mode insertion. (Hérité de DataControlField.)
Propriété protégée IsTrackingViewState Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage. (Hérité de DataControlField.)
Propriété publique ItemStyle Obtient le style de tout contenu de type texte affiché dans un champ de contrôle de données. (Hérité de DataControlField.)
Propriété publique NullDisplayText Obtient ou définit la légende affichée pour un champ lorsque la valeur du champ est null.
Propriété publique ReadOnly Obtient ou définit une valeur indiquant si la valeur du champ peut être modifiée en mode édition.
Propriété publique ShowHeader Obtient ou définit une valeur indiquant si l'élément d'en-tête d'un champ de contrôle de données est restitué. (Hérité de DataControlField.)
Propriété publique SortExpression Obtient ou définit une expression de tri utilisée par un contrôle de source de données pour trier des données. (Hérité de DataControlField.)
Propriété protégée SupportsHtmlEncode Obtient une valeur indiquant si l'encodage en HTML est pris en charge par un objet BoundField.
Propriété protégée ViewState Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un objet DataControlField entre plusieurs demandes de la même page. (Hérité de DataControlField.)
Propriété publique Visible Obtient ou définit une valeur indiquant si un champ de contrôle de données est restitué. (Hérité de DataControlField.)
Début
  Nom Description
Méthode protégée CloneField Infrastructure. Crée une copie de l'objet dérivé de DataControlField en cours. (Hérité de DataControlField.)
Méthode protégée CopyProperties Copie les propriétés de l'objet BoundField actuel vers l'objet DataControlField spécifié. (Substitue DataControlField.CopyProperties(DataControlField).)
Méthode protégée CreateField Crée un objet BoundField vide. (Substitue DataControlField.CreateField().)
Méthode publique Equals(Object) Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.)
Méthode publique ExtractValuesFromCell Remplit l'objet System.Collections.IDictionary spécifié avec les valeurs provenant de l'objet TableCell spécifié. (Substitue DataControlField.ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean).)
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 Met en forme la valeur de champ spécifiée pour une cellule dans l'objet BoundField.
Méthode protégée GetDesignTimeValue Récupère la valeur utilisée pour la valeur d'un champ lors du rendu de l'objet BoundField dans un concepteur.
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 protégée GetValue Récupère la valeur du champ lié à l'objet BoundField.
Méthode publique Initialize Initialise l'objet BoundField. (Substitue DataControlField.Initialize(Boolean, Control).)
Méthode publique InitializeCell Initialise l'objet TableCell spécifié à l'état de ligne spécifié. (Substitue DataControlField.InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32).)
Méthode protégée InitializeDataCell Initialise l'objet TableCell spécifié à l'état de ligne spécifié.
Méthode protégée LoadViewState Restaure les informations d'état d'affichage précédemment enregistrées pour ce champ. (Substitue DataControlField.LoadViewState(Object).)
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 OnDataBindField Lie la valeur d'un champ à l'objet BoundField.
Méthode protégée OnFieldChanged Déclenche l'événement FieldChanged. (Hérité de DataControlField.)
Méthode protégée SaveViewState Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur. (Hérité de DataControlField.)
Méthode publique ToString Retourne une chaîne qui représente cet objet DataControlField. (Hérité de DataControlField.)
Méthode protégée TrackViewState Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page. (Hérité de DataControlField.)
Méthode publique ValidateSupportsCallback Détermine si les contrôles contenus dans un objet BoundField prennent en charge les rappels. (Substitue DataControlField.ValidateSupportsCallback().)
Début
  Nom Description
Champ public Membre statique ThisExpression Infrastructure. Représente l'expression "this".
Début
  Nom Description
Implémentation d'interface explicite Propriété privée IDataSourceViewSchemaAccessor.DataSourceViewSchema Infrastructure. Obtient ou définit le schéma associé à cet objet DataControlField. (Hérité de DataControlField.)
Implémentation d'interface explicite Propriété privée IStateManager.IsTrackingViewState Infrastructure. Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage. (Hérité de DataControlField.)
Implémentation d'interface explicite Méthode privée IStateManager.LoadViewState Infrastructure. Restaure l'état d'affichage enregistré précédemment pour le champ de contrôle de données. (Hérité de DataControlField.)
Implémentation d'interface explicite Méthode privée IStateManager.SaveViewState Infrastructure. Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur. (Hérité de DataControlField.)
Implémentation d'interface explicite Méthode privée IStateManager.TrackViewState Infrastructure. Ainsi, l'objet DataControlField effectue le suivi des modifications de son état d'affichage afin qu'elles puissent être stockées dans la propriété ViewState du contrôle et être persistantes entre les demandes de la même page. (Hérité de DataControlField.)
Début

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 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 encodé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 encodée du champ est utilisée dans la chaîne de mise en forme personnalisée. Par défaut, la chaîne de format est appliquée aux valeurs de champ uniquement lorsque le contrôle lié aux données est en mode 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 la section 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.

Remarque Remarque

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

C#
VB
Copier 


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

<!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" >
  <head runat="server">
    <title>BoundField Example</title>
</head>
<body>
    <form id="form1" 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>

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.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
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Confidentialité