Cette documentation est archivée et n’est pas conservée.

DataControlFieldCollection, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Représente une collection d'objets DataControlField qui sont utilisés par les contrôles liés aux données tels que GridView et DetailsView.

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

public sealed class DataControlFieldCollection : StateManagedCollection
public final class DataControlFieldCollection extends StateManagedCollection
public final class DataControlFieldCollection extends StateManagedCollection

La classe DataControlFieldCollection représente une collection d'objets DataControlField utilisée par les contrôles liés aux données pour spécifier comment leurs contrôles enfants sont présentés. La classe DataControlFieldCollection dérive de StateManagedCollection, une classe de collection de base abstraite utilisée spécifiquement pour stocker des objets IStateManager.

Un objet StateManagedCollection influence le comportement d'un objet DataControlFieldCollection. Les objets DataControlField qui sont ajoutés dynamiquement à la collection seront ajoutés de nouveau au contrôle lorsque l'état aura été restauré. Cela signifie qu'un champ doit être ajouté, supprimé ou modifié une fois seulement plutôt qu'à chaque publication, comme la plupart des types de collections d'ASP.NET le requièrent.

(La classe DataControlField implémente l'interface IStateManager, ce qui lui permet de stocker son état dans l'état d'affichage ASP.NET.)

Utilisez la classe DataControlFieldCollection pour gérer par programme un ensemble d'objets DataControlField. Notez qu'il est plus courant de définir ces champs de manière déclarative.

Vous pouvez ajouter, insérer et supprimer des objets DataControlField à l'aide des méthodes appropriées de la classe DataControlFieldCollection. Pour récupérer par programme des objets DataControlField à partir d'une collection, utilisez l'une des méthodes suivantes :

  • Utilisez l'indexeur pour obtenir un seul objet DataControlField de la collection à l'aide d'une notation de tableau.

  • Utilisez la méthode GetEnumerator pour créer un objet implémentant System.Collections.IEnumerator, pouvant ensuite être utilisé pour obtenir des éléments de la collection.

La propriété Count spécifie le nombre total d'éléments dans la collection et est généralement utilisée pour déterminer la limite supérieure de la collection. Vous pouvez ajouter des éléments dans la collection ou en supprimer à l'aide des méthodes Add, Insert, Remove et RemoveAt.

Si vous utilisez le contrôle GridView ou DetailsView, les objets DataControlField qui sont créés automatiquement (par exemple, lorsque la propriété AutoGenerateColumns est true) ne sont pas stockés dans la collection de champs accessible publiquement. Vous pouvez uniquement accéder et manipuler des objets DataControlField qui ne sont pas générés automatiquement.

Le tableau suivant répertorie les classes de champ de contrôle de données différentes et leur utilisation.

Classe Parameter

Description

DataControlField

Classe de base abstraite pour tous les champs.

BoundField

Champ de contrôle lié aux données qui est utilisé pour créer une liaison avec du texte ou des données récupérés d'un contrôle de source de données ASP.NET.

ButtonFieldBase

Champ de contrôle lié aux données qui encapsule les fonctionnalités de bouton générales. ButtonField et CheckBoxField sont dérivés de ce champ.

ButtonField

Champ de contrôle lié aux données qui affiche au moins un bouton.

CheckBoxField

Champ de contrôle lié aux données qui affiche un contrôle CheckBox.

CommandField

Champ de contrôle lié aux données qui affiche les actions qui peuvent être exécutées sur les données affichées par la ligne (ou colonne), telles que la modification, la mise à jour ou la suppression.

HyperLinkField

Champ de contrôle lié aux données qui affiche un contrôle HyperLink.

ImageField

Champ de contrôle lié aux données qui affiche un contrôle Image.

TemplateField

Champ de contrôle lié aux données qui affiche le contenu personnalisé dans un contrôle lié aux données.

  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

System.Object
   System.Web.UI.StateManagedCollection
    System.Web.UI.WebControls.DataControlFieldCollection

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

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.

.NET Framework

Prise en charge dans : 2.0
Afficher: