DetailsView.Fields, propriété
Assembly : System.Web (dans system.web.dll)
/** @property */ public DataControlFieldCollection get_Fields ()
public function get Fields () : DataControlFieldCollection
Valeur de la propriété
DataControlFieldCollection qui contient tous les champs de ligne déclarés explicitement dans le contrôle DetailsView.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. |
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 |
|---|---|
| Affiche la valeur d'un champ dans une source de données sous la forme de texte. | |
| Affiche un bouton de commande dans le contrôle DetailsView. Cela vous permet d'afficher une ligne avec un contrôle de bouton personnalisé, par exemple un bouton Ajouter ou Supprimer. | |
| 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. | |
| 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. | |
| 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. | |
| Affiche une image dans le contrôle DetailsView. | |
| 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.
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.
<%@ Page language="C#" %> <script runat="server"> </script> <html> <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>
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.
