DataControlFieldCollection Classe

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Représente une collection d’objets DataControlField utilisés par des 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 StateManagedCollectionclasse de collection 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 sont ajoutés à nouveau 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’interface IStateManager , 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 méthodes, Insertet RemoveRemoveAt les Addéléments.

Si vous utilisez le ou DetailsView le GridView contrôle, les DataControlField objets qui sont 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 aux objets qui ne sont pas générés automatiquement et les manipuler DataControlField .

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

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

Nom	Description
DataControlFieldCollection()	Initialise une nouvelle instance de la classe DataControlFieldCollection.

Propriétés

Nom	Description
Count	Obtient le nombre d’éléments contenus dans la StateManagedCollection collection. (Hérité de StateManagedCollection)
Item[Int32]	Obtient ou définit l’objet DataControlField à l’index spécifié dans la collection.

Méthodes

Nom	Description
Add(DataControlField)	Ajoute l’objet spécifié DataControlField à la fin de la collection.
Clear()	Supprime tous les éléments de la StateManagedCollection collection. (Hérité de StateManagedCollection)
CloneFields()	Crée une copie de la collection active.
Contains(DataControlField)	Détermine si la DataControlFieldCollection collection contient un objet spécifique DataControlField .
CopyTo(Array, Int32)	Copie les éléments de la StateManagedCollection collection dans un tableau, en commençant par un index de tableau particulier. (Hérité de StateManagedCollection)
CopyTo(DataControlField[], Int32)	Copie l’intégralité DataControlFieldCollection de la collection vers une dimension unidimensionnelle Arraycompatible, en commençant à 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éé est basé sur le membre spécifié de la collection retournée par la GetKnownTypes() méthode. (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 dans la StateManagedCollection collection. (Hérité de StateManagedCollection)
GetHashCode()	Sert 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 IStateManager types que la StateManagedCollection collection peut contenir. (Hérité de StateManagedCollection)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IndexOf(DataControlField)	Détermine l’index d’un objet spécifique DataControlField dans la collection.
Insert(Int32, DataControlField)	Insère l’objet spécifié DataControlField dans la DataControlFieldCollection collection à l’index spécifié.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnClear()	En cas de substitution dans une classe dérivée, effectue un travail supplémentaire avant que la Clear() méthode supprime tous les éléments de la collection. (Hérité de StateManagedCollection)
OnClearComplete()	En cas de substitution dans une classe dérivée, effectue un travail supplémentaire une fois la Clear() méthode terminée la suppression de tous les éléments de la collection. (Hérité de StateManagedCollection)
OnInsert(Int32, Object)	En cas de substitution dans une classe dérivée, effectue un travail supplémentaire avant l’ajout IList.Insert(Int32, Object)IList.Add(Object) d’un élément à la collection. (Hérité de StateManagedCollection)
OnInsertComplete(Int32, Object)	En cas de substitution dans une classe dérivée, effectue un travail supplémentaire après l’ajout IList.Insert(Int32, Object)IList.Add(Object) d’un élément à la collection. (Hérité de StateManagedCollection)
OnRemove(Int32, Object)	En cas de substitution dans une classe dérivée, effectue un travail supplémentaire avant que la ou IList.RemoveAt(Int32) la IList.Remove(Object) méthode 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, effectue un travail supplémentaire après la suppression de l’élément IList.Remove(Object)IList.RemoveAt(Int32) 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 StateManagedCollection collection. (Hérité de StateManagedCollection)
Remove(DataControlField)	Supprime l’objet spécifié DataControlField de la DataControlFieldCollection collection.
RemoveAt(Int32)	Supprime l’objet à l’index DataControlField spécifié de la DataControlFieldCollection collection.
SetDirty()	Force la sérialisation de l’ensemble StateManagedCollection de la collection dans l’état d’affichage. (Hérité de StateManagedCollection)
SetDirtyObject(Object)	En cas de substitution dans une classe dérivée, indique à une collection d’enregistrer object son état entier pour afficher l’état, plutôt que d’enregistrer uniquement les informations de modification. (Hérité de StateManagedCollection)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Événements

Nom	Description
FieldsChanged	Se produit lorsque les champs de la collection changent, généralement à la suite d’un appel de méthode ou d’un Clear()Insert(Int32, DataControlField)Remove(DataControlField)Add(DataControlField) appel de méthode. Cet événement est également déclenché chaque fois qu’un DataControlField élément de la collection déclenche son FieldChanged événement.

Implémentations d’interfaces explicites

Nom	Description
ICollection.Count	Obtient le nombre d’éléments contenus dans la StateManagedCollection collection. (Hérité de StateManagedCollection)
ICollection.IsSynchronized	Obtient une valeur indiquant si la StateManagedCollection collection 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 StateManagedCollection collection. Cette méthode retourne null dans tous les cas. (Hérité de StateManagedCollection)
IEnumerable.GetEnumerator()	Retourne un itérateur qui itère dans la StateManagedCollection collection. (Hérité de StateManagedCollection)
IList.Add(Object)	Ajoute un élément à la StateManagedCollection collection. (Hérité de StateManagedCollection)
IList.Clear()	Supprime tous les éléments de la StateManagedCollection collection. (Hérité de StateManagedCollection)
IList.Contains(Object)	Détermine si la StateManagedCollection collection contient une valeur spécifique. (Hérité de StateManagedCollection)
IList.IndexOf(Object)	Détermine l’index d’un élément spécifié dans la StateManagedCollection collection. (Hérité de StateManagedCollection)
IList.Insert(Int32, Object)	Insère un élément dans la collection à l’index StateManagedCollection spécifié. (Hérité de StateManagedCollection)
IList.IsFixedSize	Obtient une valeur indiquant si la StateManagedCollection collection a une taille fixe. Cette méthode retourne false dans tous les cas. (Hérité de StateManagedCollection)
IList.IsReadOnly	Obtient une valeur indiquant si la StateManagedCollection collection 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é de la StateManagedCollection collection. (Hérité de StateManagedCollection)
IList.RemoveAt(Int32)	Supprime l’élément IStateManager à l’index spécifié. (Hérité de StateManagedCollection)
IStateManager.IsTrackingViewState	Obtient une valeur indiquant si la StateManagedCollection collection enregistre les modifications apportées à son état d’affichage. (Hérité de StateManagedCollection)
IStateManager.LoadViewState(Object)	Restaure l’état d’affichage enregistré précédemment de la StateManagedCollection collection et les IStateManager éléments qu’il contient. (Hérité de StateManagedCollection)
IStateManager.SaveViewState()	Enregistre les modifications apportées à la StateManagedCollection collection et à chaque IStateManager objet qu’elle contient depuis la publication de la page sur le serveur. (Hérité de StateManagedCollection)
IStateManager.TrackViewState()	Provoque la persistance de la StateManagedCollectionIStateManager collection et de chacun des objets qu’elle contient pour suivre les modifications apportées à leur état d’affichage afin qu’elles puissent être conservées dans les requêtes pour la même page. (Hérité de StateManagedCollection)

Méthodes d’extension

Nom	Description
AsParallel(IEnumerable)	Active la parallélisation d’une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.
Cast<TResult>(IEnumerable)	Convertit les éléments d’un IEnumerable en type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d’une IEnumerable en fonction d’un type spécifié.

Voir aussi

• DataControlField
• GridView
• DetailsView