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

DetailsView.Fields, propriété

.NET Framework 4

Autres versions

Obtient une collection d'objets DataControlField qui représentent les champs de ligne déclarés explicitement dans un contrôle DetailsView.

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

Syntaxe

C++

Copier

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public virtual DataControlFieldCollection Fields { get; }

Valeur de propriété

Type : System.Web.UI.WebControls.DataControlFieldCollection
DataControlFieldCollection qui contient tous les champs de ligne déclarés explicitement dans le contrôle DetailsView.

Notes

Lorsque vous déclarez explicitement les champs de ligne d'un contrôle DetailsView, ces champs de ligne sont stockés dans la propriété (collection) Fields. La collection Fields vous permet également de gérer par programme la collection des lignes déclarées explicitement.

Remarque
Les champs de ligne déclarés explicitement peuvent être utilisés en association avec les champs de ligne générés automatiquement. Lorsque vous utilisez les deux types de lignes, les champs de ligne déclarés explicitement sont rendus en premier, suivis des champs de ligne générés automatiquement. Les champs de ligne générés automatiquement ne sont pas ajoutés à la collection Fields.

Remarque

Les champs de ligne déclarés explicitement peuvent être utilisés en association avec les champs de ligne générés automatiquement. Lorsque vous utilisez les deux types de lignes, les champs de ligne déclarés explicitement sont rendus en premier, suivis des champs de ligne générés automatiquement. Les champs de ligne générés automatiquement ne sont pas ajoutés à la collection Fields.

Différents types de champs de ligne déterminent le comportement des lignes dans le contrôle. Le tableau suivant répertorie les différents types de champs de ligne qui peuvent être utilisés dans la collection Fields.

Type de champ de ligne	Description
BoundField	Affiche la valeur d'un champ dans une source de données sous la forme de texte.
ButtonField	Affiche un bouton de commande dans le contrôle DetailsView. Cela vous permet d'afficher une ligne avec un contrôle bouton personnalisé, par exemple un bouton Ajouter ou Supprimer.
CheckBoxField	Affiche une case à cocher dans le contrôle DetailsView. Ce type de champ de ligne est couramment utilisé pour afficher les champs avec une valeur Boolean.
CommandField	Affiche des boutons de commande intégrés pour exécuter des opérations de modification, d'insertion ou de suppression dans le contrôle DetailsView.
HyperLinkField	Affiche la valeur d'un champ dans une source de données sous la forme de lien hypertexte. Ce type de champ de ligne vous permet de lier un deuxième champ à l'URL du lien hypertexte.
ImageField	Affiche une image dans le contrôle DetailsView.
TemplateField	Affiche le contenu défini par l'utilisateur pour une ligne dans le contrôle DetailsView en fonction d'un modèle spécifié. Ce type de champ de ligne vous permet de créer un champ de ligne personnalisé.

Pour déclarer explicitement les champs de ligne d'un contrôle DetailsView, affectez d'abord la valeur false à la propriété AutoGenerateRows. Ensuite, ajoutez les balises d'ouverture et de fermeture <Fields> entre les balises d'ouverture et de fermeture du contrôle DetailsView. Enfin, répertoriez les champs de ligne que vous souhaitez inclure entre les balises d'ouverture et de fermeture <Fields>. Les champs de ligne sont affichés dans le contrôle DetailsView dans l'ordre dans lequel ils apparaissent dans la collection Fields.

Bien que vous puissiez ajouter par programme des champs de ligne à la collection Fields, il est plus facile de répertorier de façon déclarative les champs de ligne dans le contrôle DetailsView, puis d'utiliser la propriété Visible de chaque champ de ligne pour afficher ou masquer le champ de ligne.

Si la propriété Visible d'un champ de ligne a la valeur false, la ligne n'est pas affichée dans le contrôle DetailsView et les données de la ligne ne font pas d'aller-retour vers le client. Si vous souhaitez les données d'une ligne qui n'est pas visible pour faire un aller-retour, ajoutez le nom de champ à la propriété DataKeyNames.

Exemples

L'exemple de code suivant montre comment ajouter de manière déclarative des champs de ligne à la collection Fields d'un contrôle DetailsView.

Copier



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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView Fields Example</title>
</head>
<body>
    <form id="Form1" runat="server">

      <h3>DetailsView Fields Example</h3>

        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          AutoGenerateRows="false"
          allowpaging="true"
          runat="server">

        <Fields>
         <asp:BoundField 
           DataField="CompanyName" 
           HeaderText="Company Name"/>
         <asp:BoundField 
           DataField="City" 
           HeaderText="City"/>
        </Fields>

        </asp:detailsview>

        <!-- 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="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID],
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"

          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] From 
            [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>

Informations de version

.NET Framework

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

Plateformes

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.

Voir aussi