DataControlFieldCollection Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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: Object

StateManagedCollection
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 Remove RemoveAt 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 à