Partager via


DataControlFieldCollection Classe

Définition

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.

public ref class DataControlFieldCollection sealed : System::Web::UI::StateManagedCollection
public sealed class DataControlFieldCollection : System.Web.UI.StateManagedCollection
type DataControlFieldCollection = class
    inherit StateManagedCollection
Public NotInheritable Class DataControlFieldCollection
Inherits StateManagedCollection
Héritage
DataControlFieldCollection

Remarques

La DataControlFieldCollection classe représente une collection d’objets DataControlField utilisés par les contrôles liés aux données pour spécifier la façon dont leurs contrôles enfants sont présentés. La DataControlFieldCollection classe dérive d’une classe de StateManagedCollectioncollection de base abstraite utilisée spécifiquement pour stocker IStateManager des objets.

Un StateManagedCollection objet influence le comportement d’un DataControlFieldCollection objet. DataControlField les objets ajoutés dynamiquement à la collection seront réinscrits au contrôle lors de la restauration de l’état. Cela signifie qu’un champ doit être ajouté, supprimé ou modifié une seule fois au lieu de chaque publication, car la plupart des types de collection dans ASP.NET nécessitent.

(La DataControlField classe implémente l’interfaceIStateManager, qui lui permet de stocker son état dans ASP.NET’état d’affichage. )

Utilisez la DataControlFieldCollection classe pour gérer par programmation 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 DataControlField des objets à l’aide des méthodes appropriées de la DataControlFieldCollection classe. Pour récupérer DataControlField des objets d’une collection par programmation, utilisez l’une des méthodes suivantes :

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

  • Utilisez la GetEnumerator méthode pour créer un System.Collections.IEnumeratorobjet implémenté, qui peut ensuite être utilisé pour obtenir des éléments de la collection.

La Count propriété spécifie le nombre total d’éléments de la collection et est couramment utilisée pour déterminer la limite supérieure de la collection. Vous pouvez ajouter et supprimer des éléments de la collection à l’aide des Addméthodes , Insertet RemoveRemoveAt des éléments.

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

Le tableau suivant répertorie les différentes classes de champ de contrôle de données et la façon dont elles sont utilisées.

Parameter, classe Description
DataControlField Classe de base abstraite pour tous les champs.
BoundField Champ de contrôle lié aux données utilisé pour lier du texte ou des données récupérées à partir 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 générales du bouton. ButtonField et CheckBoxField sont dérivés de celui-ci.
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 CheckBox contrôle.
CommandField Champ de contrôle lié aux données qui affiche les actions qui peuvent être effectué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 HyperLink contrôle.
ImageField Champ de contrôle lié aux données qui affiche un Image contrôle.
TemplateField Champ de contrôle lié aux données qui affiche du contenu personnalisé dans un contrôle lié aux données.

Constructeurs

DataControlFieldCollection()

Initialise une nouvelle instance de la classe DataControlFieldCollection.

Propriétés

Count

Obtient le nombre d'éléments contenus dans la collection StateManagedCollection.

(Hérité de StateManagedCollection)
Item[Int32]

Obtient ou définit l'objet DataControlField à l'index spécifié dans la collection.

Méthodes

Add(DataControlField)

Ajoute l'objet DataControlField spécifié à la fin de la collection.

Clear()

Supprime tous les éléments de la collection StateManagedCollection.

(Hérité de StateManagedCollection)
CloneFields()

Crée une copie de la collection en cours.

Contains(DataControlField)

Détermine si la collection DataControlFieldCollection contient un objet DataControlField spécifique.

CopyTo(Array, Int32)

Copie les éléments de la collection StateManagedCollection dans un tableau, en commençant au niveau d'un index de tableau particulier.

(Hérité de StateManagedCollection)
CopyTo(DataControlField[], Int32)

Copie la totalité de la collection DataControlFieldCollection dans un Array compatible unidimensionnel, à partir de l'index spécifié du tableau cible.

CreateKnownType(Int32)

En cas de substitution dans une classe dérivée, crée une instance d'une classe qui implémente IStateManager. Le type d'objet créé repose sur le membre spécifié de la collection retournée par la méthode GetKnownTypes().

(Hérité de StateManagedCollection)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetEnumerator()

Retourne un itérateur qui itère au sein de la collection StateManagedCollection.

(Hérité de StateManagedCollection)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetKnownTypes()

En cas de substitution dans une classe dérivée, obtient un tableau de types IStateManager que la collection StateManagedCollection peut contenir.

(Hérité de StateManagedCollection)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
IndexOf(DataControlField)

Détermine l'index d'un objet DataControlField spécifique de la collection.

Insert(Int32, DataControlField)

Insère l'objet DataControlField spécifié dans la collection DataControlFieldCollection à l'index spécifié.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnClear()

En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire avant que la méthode Clear() supprime tous les éléments de la collection.

(Hérité de StateManagedCollection)
OnClearComplete()

En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire une fois tous les éléments de la collection supprimés par la méthode Clear().

(Hérité de StateManagedCollection)
OnInsert(Int32, Object)

En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire avant que la méthode IList.Insert(Int32, Object) ou IList.Add(Object) ajoute un élément à la collection.

(Hérité de StateManagedCollection)
OnInsertComplete(Int32, Object)

En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire après que la méthode IList.Insert(Int32, Object) ou IList.Add(Object) a ajouté un élément à la collection.

(Hérité de StateManagedCollection)
OnRemove(Int32, Object)

En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire avant que la méthode IList.Remove(Object) ou IList.RemoveAt(Int32) supprime l'élément spécifié de la collection.

(Hérité de StateManagedCollection)
OnRemoveComplete(Int32, Object)

En cas de substitution dans une classe dérivée, exécute une tâche supplémentaire après que la méthode IList.Remove(Object) ou IList.RemoveAt(Int32) a supprimé l'élément spécifié de la collection.

(Hérité de StateManagedCollection)
OnValidate(Object)

En cas de substitution dans une classe dérivée, valide un élément de la collection StateManagedCollection.

(Hérité de StateManagedCollection)
Remove(DataControlField)

Supprime de la collection DataControlField l'objet DataControlFieldCollection spécifié.

RemoveAt(Int32)

Supprime l'objet DataControlField de la collection DataControlFieldCollection à l'index spécifié.

SetDirty()

Force la sérialisation de l'intégralité de la collection StateManagedCollection dans l'état d'affichage.

(Hérité de StateManagedCollection)
SetDirtyObject(Object)

En cas de substitution dans une classe dérivée, commande à un object contenu dans la collection d'enregistrer l'intégralité de son état dans l'état d'affichage, plutôt que d'enregistrer uniquement des informations relatives aux modifications.

(Hérité de StateManagedCollection)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Événements

FieldsChanged

Se produit lorsque les champs de la collection sont modifiés, ce qui est généralement dû à un Clear(), Insert(Int32, DataControlField), Remove(DataControlField) ou à un appel de méthode Add(DataControlField). Cet événement est également déclenché chaque fois qu'un DataControlField de la collection déclenche son événement FieldChanged.

Implémentations d’interfaces explicites

ICollection.Count

Obtient le nombre d'éléments contenus dans la collection StateManagedCollection.

(Hérité de StateManagedCollection)
ICollection.IsSynchronized

Obtient une valeur indiquant si la collection StateManagedCollection est synchronisée (thread-safe). Cette méthode retourne false dans tous les cas.

(Hérité de StateManagedCollection)
ICollection.SyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l'accès à la collection StateManagedCollection. Cette méthode retourne null dans tous les cas.

(Hérité de StateManagedCollection)
IEnumerable.GetEnumerator()

Retourne un itérateur qui itère au sein de la collection StateManagedCollection.

(Hérité de StateManagedCollection)
IList.Add(Object)

Ajoute un élément à la collection StateManagedCollection.

(Hérité de StateManagedCollection)
IList.Clear()

Supprime tous les éléments de la collection StateManagedCollection.

(Hérité de StateManagedCollection)
IList.Contains(Object)

Détermine si la collection StateManagedCollection contient une valeur spécifique.

(Hérité de StateManagedCollection)
IList.IndexOf(Object)

Détermine l'index d'un élément spécifié de la collection StateManagedCollection.

(Hérité de StateManagedCollection)
IList.Insert(Int32, Object)

Insère un élément dans la collection StateManagedCollection au niveau de l'index spécifié.

(Hérité de StateManagedCollection)
IList.IsFixedSize

Obtient une valeur indiquant si la collection StateManagedCollection est de taille fixe. Cette méthode retourne false dans tous les cas.

(Hérité de StateManagedCollection)
IList.IsReadOnly

Obtient une valeur indiquant si la collection StateManagedCollection est en lecture seule.

(Hérité de StateManagedCollection)
IList.Item[Int32]

Obtient l’élément IStateManager à l’index spécifié.

(Hérité de StateManagedCollection)
IList.Remove(Object)

Supprime la première occurrence de l'objet spécifié dans la collection StateManagedCollection.

(Hérité de StateManagedCollection)
IList.RemoveAt(Int32)

Supprime l'élément IStateManager au niveau de l'index spécifié.

(Hérité de StateManagedCollection)
IStateManager.IsTrackingViewState

Obtient une valeur indiquant si la collection StateManagedCollection enregistre les modifications apportées à son état d'affichage.

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

Restaure l'état d'affichage précédemment enregistré de la collection StateManagedCollection et les éléments IStateManager qu'elle contient.

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

Enregistre les modifications apportées à la collection StateManagedCollection et à chaque objet IStateManager qu'elle contient, depuis la publication de la page sur le serveur.

(Hérité de StateManagedCollection)
IStateManager.TrackViewState()

Commande à la collection StateManagedCollection et à chacun des objets IStateManager qu'elle contient de procéder au suivi des modifications apportées à leur état d'affichage afin qu'ils puissent être rendus persistants au fil des requêtes d'une même page.

(Hérité de StateManagedCollection)

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.

S’applique à

Voir aussi