BoundField Classe

Définition

Représente un champ qui s’affiche en tant que texte dans un contrôle lié aux données.Represents a field that is displayed as text in a data-bound control.

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
Dérivé

Exemples

L’exemple de code suivant montre comment utiliser un BoundField objet pour afficher les valeurs d’un champ dans un GridView contrôle.The following code example demonstrates how to use a BoundField object to display the values of a field in a GridView control.


<%@ 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.The BoundField class is used by data-bound controls (such as GridView and DetailsView) to display the value of a field as text. L' BoundField objet est affiché différemment en fonction du contrôle lié aux données dans lequel il est utilisé.The BoundField object is displayed differently depending on the data-bound control in which it is used. Par exemple, le GridView contrôle affiche un BoundField objet sous la forme d’une colonne, tandis que le DetailsView contrôle l’affiche sous forme de ligne.For example, the GridView control displays a BoundField object as a column, while the DetailsView control displays it as a row.

Pour spécifier le champ à afficher dans un BoundField objet, affectez DataField à la propriété le nom du champ.To specify the field to display in a BoundField object, set the DataField property to the field's name. La valeur du champ peut être encodée en HTML avant d’être affichée en affectant HtmlEncode à la propriété la valeur true .The field's value can be HTML-encoded before it is displayed by setting the HtmlEncode property to true. Vous pouvez appliquer une chaîne de mise en forme personnalisée à la valeur du champ en définissant la DataFormatString propriété.You can apply a custom formatting string to the field's value by setting the DataFormatString property. Lorsque la HtmlEncode propriété a la true valeur, la valeur de chaîne encodée du champ est utilisée dans la chaîne de format personnalisée.When the HtmlEncode property is true, the encoded string value of the field is used in the custom format string. 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.By default, the formatting string is applied to field values only when the data-bound control is in read-only mode. 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, affectez à la propriété la valeur ApplyFormatInEditMode true .To apply the formatting string to values displayed while the data-bound control is in edit mode, set the ApplyFormatInEditMode property to true. Si la valeur d’un champ est null, vous pouvez afficher une légende personnalisée en définissant la NullDisplayText propriété.If a field's value is null, you can display a custom caption by setting the NullDisplayText property. L' BoundField objet peut également convertir automatiquement les valeurs de champ de chaîne vide ("") en valeurs NULL en affectant à la propriété la valeur ConvertEmptyStringToNull true .The BoundField object can also automatically convert empty string ("") field values to null values by setting the ConvertEmptyStringToNull property to true.

Vous pouvez masquer un BoundField objet dans un contrôle lié aux données en affectant Visible à la propriété la valeur false .You can hide a BoundField object in a data-bound control by setting the Visible property to false. Pour empêcher la modification de la valeur d’un champ en mode édition, affectez ReadOnly à la propriété la valeur true .To prevent the value of a field from being modified in edit mode, set the ReadOnly property to true. 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 affectant à la propriété la valeur InsertVisible false .In data-bound controls that support inserting records (such as the DetailsView control), you can hide a BoundField object by setting the InsertVisible property to false. Cela s’effectue généralement lorsque vous souhaitez masquer un champ clé généré automatiquement en mode insertion.This is commonly done when you want to hide an automatically generated key field in insert mode.

Vous pouvez personnaliser les sections d’en-tête et de pied de page d’un BoundField objet.You can customize the header and footer sections of a BoundField object. Pour afficher une légende dans les sections d’en-tête ou de pied de page, définissez les HeaderText FooterText Propriétés ou, respectivement.To display a caption in the header or footer sections, set the HeaderText or FooterText properties, respectively. 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é.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property. La section d’en-tête peut être masquée dans l' BoundField objet en affectant à la propriété la valeur ShowHeader false .The header section can be hidden in the BoundField object by setting the ShowHeader property to false.

Notes

Certains contrôles liés aux données (tels que le GridView contrôle) peuvent afficher ou masquer uniquement l’intégralité de la section d’en-tête du contrôle.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Ces contrôles liés aux données ne prennent pas en charge la ShowHeader propriété d’un champ lié individuel.These data-bound controls do not support the ShowHeader property for an individual bound field. Pour afficher ou masquer l’intégralité de la section d’en-tête d’un contrôle lié aux données (si disponible), utilisez la propriété du contrôle ShowHeader .To show or hide the entire header section of a data-bound control (if available), use the control's ShowHeader property.

Vous pouvez également personnaliser l’apparence de l' BoundField objet (couleur de police, couleur d’arrière-plan, etc.) en définissant les propriétés de style pour les différentes parties du champ.You also can customize the appearance of the BoundField object (font color, background color, and so on) by setting the style properties for the different parts of the field. Le tableau suivant répertorie les différentes propriétés de style.The following table lists the different style properties.

Propriété styleStyle property DescriptionDescription
ControlStyle Paramètres de style pour les contrôles serveur Web enfants de l' BoundField objet.The style settings for the child Web server controls of the BoundField object.
FooterStyle Paramètres de style de la section de pied de page de l' BoundField objet.The style settings for the footer section of the BoundField object.
HeaderStyle Paramètres de style de la section d’en-tête de l' BoundField objet.The style settings for the header section of the BoundField object.
ItemStyle Paramètres de style pour les éléments de données de l' BoundField objet.The style settings for the data items in the BoundField object.

Constructeurs

BoundField()

Initialise une nouvelle instance de la classe BoundField.Initializes a new instance of the BoundField class.

Champs

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 ».Represents the "this" expression.

Propriétés

AccessibleHeaderText

Obtient ou définit le texte restitué sous forme de valeur de propriété AbbreviatedText dans certains contrôles.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(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 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.Gets or sets a value indicating whether the formatting string specified by the DataFormatString property is applied to field values when the data-bound control that contains the BoundField object is in edit mode.

Control

Obtient une référence au contrôle de données auquel l'objet DataControlField est associé.Gets a reference to the data control that the DataControlField object is associated with.

(Hérité de DataControlField)
ControlStyle

Obtient le style de tout contrôle serveur Web contenu dans l'objet DataControlField.Gets the style of any Web server controls contained by the DataControlField object.

(Hérité de DataControlField)
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.Gets or sets a value indicating whether empty string values ("") are automatically converted to null values when the data field is updated in the data source.

DataField

Obtient ou définit le nom du champ de données lié à lier à l'objet BoundField.Gets or sets the name of the data field to bind to the BoundField object.

DataFormatString

Obtient ou définit la chaîne qui spécifie le format d'affichage de la valeur du champ.Gets or sets the string that specifies the display format for the value of the field.

DesignMode

Obtient une valeur indiquant si un champ de contrôle de données est actuellement affiché dans un environnement au moment du design.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Hérité de DataControlField)
FooterStyle

Obtient ou définit le style du pied de page du champ de contrôle de données.Gets or sets the style of the footer of the data control field.

(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.Gets or sets the text that is displayed in the footer item of a data control field.

(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.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Hérité de DataControlField)
HeaderStyle

Obtient ou définit le style de l'en-tête du champ de contrôle de données.Gets or sets the style of the header of the data control field.

(Hérité de DataControlField)
HeaderText

Obtient ou définit le texte qui s'affiche dans l'en-tête d'un contrôle de données.Gets or sets the text that is displayed in the header of a data control.

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.Gets or sets a value indicating whether field values are HTML-encoded before they are displayed in a BoundField object.

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é.Gets or sets a value that indicates whether text that is created by applying the DataFormatString property to the BoundField value should be HTML encoded when it is displayed.

InsertVisible

Obtient une valeur indiquant si l'objet DataControlField est visible lorsque son contrôle lié aux données parent est en mode insertion.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

(Hérité de DataControlField)
IsTrackingViewState

Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Hérité de DataControlField)
ItemStyle

Obtient le style de tout contenu de type texte affiché dans un champ de contrôle de données.Gets the style of any text-based content displayed by a data control field.

(Hérité de DataControlField)
NullDisplayText

Obtient ou définit la légende affichée pour un champ lorsque la valeur du champ est null.Gets or sets the caption displayed for a field when the field's value is null.

ReadOnly

Obtient ou définit une valeur indiquant si la valeur du champ peut être modifiée en mode édition.Gets or sets a value indicating whether the value of the field can be modified in edit mode.

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é.Gets or sets a value indicating whether the header item of a data control field is rendered.

(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 des données.Gets or sets a sort expression that is used by a data source control to sort data.

(Hérité de DataControlField)
SupportsHtmlEncode

Obtient une valeur indiquant si l'encodage en HTML est pris en charge par un objet BoundField.Gets a value indicating whether HTML encoding is supported by a BoundField object.

ValidateRequestMode

Obtient ou définit une valeur qui détermine si le contrôle valide l'entrée cliente ou non.Gets or sets a value that determines whether the control validates client input or not.

ValidateRequestMode

Obtient ou définit une valeur qui spécifie si le contrôle valide l'entrée du client.Gets or sets a value that specifies whether the control validates client input.

(Hérité de DataControlField)
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.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

(Hérité de DataControlField)
Visible

Obtient ou définit une valeur indiquant si un champ de contrôle de données est restitué.Gets or sets a value indicating whether a data control field is rendered.

(Hérité de DataControlField)

Méthodes

CloneField()

Crée une copie de l'objet dérivé de DataControlField en cours.Creates a duplicate copy of the current DataControlField-derived object.

(Hérité de DataControlField)
CopyProperties(DataControlField)

Copie les propriétés de l'objet BoundField actuel vers l'objet DataControlField spécifié.Copies the properties of the current BoundField object to the specified DataControlField object.

CreateField()

Crée un objet BoundField vide.Creates an empty BoundField object.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Remplit l'objet IDictionary spécifié avec les valeurs provenant de l'objet TableCell spécifié.Fills the specified IDictionary object with the values from the specified TableCell object.

FormatDataValue(Object, Boolean)

Met en forme la valeur de champ spécifiée pour une cellule dans l'objet BoundField.Formats the specified field value for a cell in the BoundField object.

GetDesignTimeValue()

Récupère la valeur utilisée pour un champ lors du rendu de l'objet BoundField dans un concepteur.Retrieves the value used for a field's value when rendering the BoundField object in a designer.

GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
GetValue(Control)

Récupère la valeur du champ lié à l'objet BoundField.Retrieves the value of the field bound to the BoundField object.

Initialize(Boolean, Control)

Initialise l'objet BoundField.Initializes the BoundField object.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Initialise l'objet TableCell spécifié à l'état de ligne spécifié.Initializes the specified TableCell object to the specified row state.

InitializeDataCell(DataControlFieldCell, DataControlRowState)

Initialise l'objet TableCell spécifié à l'état de ligne spécifié.Initializes the specified TableCell object to the specified row state.

LoadViewState(Object)

Restaure les informations d'état d'affichage précédemment enregistrées pour ce champ.Restores the previously stored view-state information for this field.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnDataBindField(Object, EventArgs)

Lie la valeur d'un champ à l'objet BoundField.Binds the value of a field to the BoundField object.

OnFieldChanged()

Déclenche l’événement FieldChanged.Raises the FieldChanged event.

(Hérité de DataControlField)
SaveViewState()

Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Hérité de DataControlField)
ToString()

Retourne une chaîne qui représente cet objet DataControlField.Returns a string that represents this DataControlField object.

(Hérité de DataControlField)
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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Hérité de DataControlField)
ValidateSupportsCallback()

Détermine si les contrôles contenus dans un objet BoundField prennent en charge les rappels.Determines whether the controls contained in a BoundField object support callbacks.

Implémentations d’interfaces explicites

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Obtient ou définit le schéma associé à cet objet DataControlField.Gets or sets the schema associated with this DataControlField object.

(Hérité de DataControlField)
IStateManager.IsTrackingViewState

Obtient une valeur indiquant si l'objet DataControlField enregistre les modifications apportées à son état d'affichage.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Hérité de DataControlField)
IStateManager.LoadViewState(Object)

Restaure l'état d'affichage enregistré précédemment pour le champ de contrôle de données.Restores the data control field's previously saved view state.

(Hérité de DataControlField)
IStateManager.SaveViewState()

Enregistre les modifications apportées à l'état d'affichage DataControlField depuis la publication de la page sur le serveur.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Hérité de DataControlField)
IStateManager.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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Hérité de DataControlField)

S’applique à

Voir aussi