BoundField Classe

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.

Représente un champ affiché sous forme de texte dans un contrôle lié aux données.

public ref class BoundField : System::Web::UI::WebControls::DataControlField

public class BoundField : System.Web.UI.WebControls.DataControlField

type BoundField = class
    inherit DataControlField

Public Class BoundField
Inherits DataControlField

Héritage: Object

DataControlField
BoundField

Dérivé: System.Web.UI.WebControls.AutoGeneratedField

System.Web.UI.WebControls.CheckBoxField

Exemples

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


<%@ 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>


<%@ Page language="VB" %>

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

Remarques

La BoundField classe 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’objet BoundField est affiché différemment en fonction du contrôle lié aux données dans lequel il est utilisé. Par exemple, le GridView contrôle affiche un BoundField objet sous forme de colonne, tandis que le DetailsView contrôle l’affiche sous forme de ligne.

Pour spécifier le champ à afficher dans un BoundField objet, définissez la propriété sur le DataField nom du champ. La valeur du champ peut être encodée au format HTML avant qu’elle ne soit affichée en définissant la HtmlEncode propriété truesur . Vous pouvez appliquer une chaîne de mise en forme personnalisée à la valeur du champ en définissant la DataFormatString propriété. Lorsque la HtmlEncode propriété est true, la valeur de chaîne encodée du champ est utilisée dans la chaîne de format 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 mode lecture seule. Pour appliquer la chaîne de mise en forme aux valeurs affichées pendant que le contrôle lié aux données est en mode édition, définissez la ApplyFormatInEditMode propriété truesur . Si la valeur d’un champ est Null, vous pouvez afficher une légende personnalisée en définissant la NullDisplayText propriété. L’objet BoundField peut également convertir automatiquement les valeurs de champ de chaîne vide (« ») en valeurs Null en définissant la propriété sur ConvertEmptyStringToNulltrue.

Vous pouvez masquer un BoundField objet dans un contrôle lié aux données en définissant la propriété sur falseVisible . Pour empêcher la modification de la valeur d’un champ en mode édition, définissez la ReadOnly propriété truesur . Dans les contrôles liés aux données qui prennent en charge l’insertion d’enregistrements (tels que le DetailsView contrôle), vous pouvez masquer un BoundField objet en définissant la InsertVisible propriété falsesur . Cela est généralement effectué lorsque vous souhaitez masquer un champ de clé généré automatiquement en mode d’insertion.

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

Note

Certains contrôles liés aux données (tels que le GridView contrôle) peuvent afficher ou masquer uniquement la section d’en-tête entière du contrôle. Ces contrôles liés aux données ne prennent pas en charge la ShowHeader propriété d’un champ lié individuel. 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é du ShowHeader contrôle.

Vous pouvez également personnaliser l’apparence de l’objet BoundField (couleur de police, couleur d’arrière-plan, et ainsi de suite) en définissant les propriétés de style pour les différentes parties du champ. Le tableau suivant répertorie les différentes propriétés de style.

Style, propriété	Description
ControlStyle	Paramètres de style pour les contrôles de serveur Web enfant de l’objet BoundField .
FooterStyle	Paramètres de style de la section 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 pour les éléments de données de l’objet BoundField .

Constructeurs

Nom	Description
BoundField()	Initialise une nouvelle instance de la classe BoundField.

Champs

Nom	Description
ThisExpression	Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code. Représente l’expression « this ».

Nom

Description

ThisExpression

Cette API prend en charge l'infrastructure du produit et n'est pas destinée à être utilisée directement à partir de votre code.

Représente l’expression « this ».

Propriétés

Nom	Description
AccessibleHeaderText	Obtient ou définit le `AbbreviatedText` texte qui est rendu en tant que valeur de propriété dans certains contrôles. (Hérité de DataControlField)
ApplyFormatInEditMode	Obtient ou définit une valeur indiquant si la chaîne de mise en forme spécifiée par la DataFormatString propriété est appliquée aux valeurs de champ lorsque le contrôle lié aux données qui contient l’objet BoundField est en mode édition.
Control	Obtient une référence au contrôle de données auquel l’objet DataControlField est associé. (Hérité de DataControlField)
ControlStyle	Obtient le style de tous les contrôles de serveur Web contenus par l’objet DataControlField . (Hérité de DataControlField)
ConvertEmptyStringToNull	Obtient ou définit une valeur indiquant si les valeurs de chaîne vide (« ») sont automatiquement converties en valeurs Null lorsque le champ de données est mis à jour dans la source de données.
DataField	Obtient ou définit le nom du champ de données à lier à l’objet BoundField .
DataFormatString	Obtient ou définit la chaîne qui spécifie le format d’affichage de la valeur du champ.
DesignMode	Obtient une valeur indiquant si un champ de contrôle de données est actuellement consulté dans un environnement au moment du design. (Hérité de DataControlField)
FooterStyle	Obtient ou définit le style du pied de page du champ de contrôle de données. (Hérité de DataControlField)
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)
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)
HeaderStyle	Obtient ou définit le style de l’en-tête du champ de contrôle de données. (Hérité de DataControlField)
HeaderText	Obtient ou définit le texte affiché dans l’en-tête d’un contrôle de données.
HtmlEncode	Obtient ou définit une valeur indiquant si les valeurs de champ sont encodées au format HTML avant qu’elles ne soient affichées dans un BoundField objet.
HtmlEncodeFormatString	Obtient ou définit une valeur qui indique si le texte créé en appliquant la DataFormatString propriété à la BoundField valeur doit être codé au format HTML lorsqu’il est affiché.
InsertVisible	Obtient une valeur indiquant si l’objet DataControlField est visible lorsque son contrôle parent lié aux données est en mode d’insertion. (Hérité de DataControlField)
IsTrackingViewState	Obtient une valeur indiquant si l’objet DataControlField enregistre les modifications apportées à son état d’affichage. (Hérité de DataControlField)
ItemStyle	Obtient le style d’un contenu textuel affiché par un champ de contrôle de données. (Hérité de DataControlField)
NullDisplayText	Obtient ou définit la légende affichée pour un champ lorsque la valeur du champ est null.
ReadOnly	Obtient ou définit une valeur indiquant si la valeur du champ peut être modifiée en mode édition.
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 rendu. (Hérité de DataControlField)
SortExpression	Obtient ou définit une expression de tri utilisée par un contrôle de source de données pour trier les données. (Hérité de DataControlField)
SupportsHtmlEncode	Obtient une valeur indiquant si l’encodage HTML est pris en charge par un BoundField objet.
ValidateRequestMode	Obtient ou définit une valeur qui détermine si le contrôle valide l’entrée du client ou non.
ViewState	Obtient un dictionnaire d’informations d’état qui vous permet d’enregistrer et de restaurer l’état d’affichage d’un DataControlField objet sur plusieurs requêtes pour la même page. (Hérité de DataControlField)
Visible	Obtient ou définit une valeur indiquant si un champ de contrôle de données est rendu. (Hérité de DataControlField)

Méthodes

Nom	Description
CloneField()	Crée une copie en double de l’objet dérivé actuel DataControlField. (Hérité de DataControlField)
CopyProperties(DataControlField)	Copie les propriétés de l’objet actif BoundField vers l’objet spécifié DataControlField .
CreateField()	Crée un objet BoundField vide.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Remplit l’objet spécifié IDictionary avec les valeurs de l’objet spécifié TableCell .
FormatDataValue(Object, Boolean)	Met en forme la valeur de champ spécifiée pour une cellule de l’objet BoundField .
GetDesignTimeValue()	Récupère la valeur utilisée pour la valeur d’un champ lors du rendu de l’objet BoundField dans un concepteur.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
GetValue(Control)	Récupère la valeur du champ lié à l’objet BoundField .
Initialize(Boolean, Control)	Initialise l'objet BoundField.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Initialise l’objet spécifié TableCell à l’état de ligne spécifié.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Initialise l’objet spécifié TableCell à l’état de ligne spécifié.
LoadViewState(Object)	Restaure les informations d’état d’affichage précédemment stockées pour ce champ.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnDataBindField(Object, EventArgs)	Lie la valeur d’un champ à l’objet BoundField .
OnFieldChanged()	Déclenche l’événement `FieldChanged`. (Hérité de DataControlField)
SaveViewState()	Enregistre les modifications apportées à l’état DataControlField d’affichage depuis la publication de la page sur le serveur. (Hérité de DataControlField)
ToString()	Retourne une chaîne qui représente cet DataControlField objet. (Hérité de DataControlField)
TrackViewState()	Provoque le DataControlField suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété du ViewState contrôle et conservés dans les requêtes pour la même page. (Hérité de DataControlField)
ValidateSupportsCallback()	Détermine si les contrôles contenus dans un BoundField objet prennent en charge les rappels.

Implémentations d’interfaces explicites

Nom	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Obtient ou définit le schéma associé à cet DataControlField objet. (Hérité de DataControlField)
IStateManager.IsTrackingViewState	Obtient une valeur indiquant si l’objet DataControlField enregistre les modifications apportées à son état d’affichage. (Hérité de DataControlField)
IStateManager.LoadViewState(Object)	Restaure l’état d’affichage précédemment enregistré du champ de contrôle de données. (Hérité de DataControlField)
IStateManager.SaveViewState()	Enregistre les modifications apportées à l’état DataControlField d’affichage depuis la publication de la page sur le serveur. (Hérité de DataControlField)
IStateManager.TrackViewState()	Provoque le DataControlField suivi des modifications apportées à son état d’affichage afin qu’ils puissent être stockés dans la propriété du ViewState contrôle et conservés dans les requêtes pour la même page. (Hérité de DataControlField)

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?