Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

DataControlFieldCollection, classe

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.

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

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

public sealed class DataControlFieldCollection : StateManagedCollection

Le type DataControlFieldCollection expose les membres suivants.

  NomDescription
Méthode publiqueDataControlFieldCollectionInitialise une nouvelle instance de la classe DataControlFieldCollection.
Début

  NomDescription
Propriété publiqueCountObtient le nombre d'éléments contenus dans la collection StateManagedCollection. (Hérité de StateManagedCollection.)
Propriété publiqueItemObtient ou définit l'objet DataControlField à l'index spécifié dans la collection.
Début

  NomDescription
Méthode publiqueAddAjoute l'objet DataControlField spécifié à la fin de la collection.
Méthode publiqueClearSupprime tous les éléments de la collection StateManagedCollection. (Hérité de StateManagedCollection.)
Méthode publiqueCloneFieldsCrée une copie de la collection en cours.
Méthode publiqueContainsDétermine si la collection DataControlFieldCollection contient un objet DataControlField spécifique.
Méthode publiqueCopyTo(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.)
Méthode publiqueCopyTo(DataControlField[], Int32)Copie l'ensemble de la collection DataControlFieldCollection dans un Array compatible unidimensionnel en commençant à l'index spécifié du tableau cible.
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode publiqueGetEnumeratorRetourne un itérateur qui itère au sein de la collection StateManagedCollection. (Hérité de StateManagedCollection.)
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueIndexOfDétermine l'index d'un objet DataControlField spécifique de la collection.
Méthode publiqueInsertInsère l'objet DataControlField spécifié dans la collection DataControlFieldCollection à l'index spécifié.
Méthode publiqueRemoveSupprime de la collection DataControlFieldCollection l'objet DataControlField spécifié.
Méthode publiqueRemoveAtSupprime de la collection DataControlFieldCollection l'objet DataControlField à l'index spécifié.
Méthode publiqueSetDirtyForce la sérialisation de l'intégralité de la collection StateManagedCollection dans l'état d'affichage. (Hérité de StateManagedCollection.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Début

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

  NomDescription
Implémentation d'interface explicitePropriété privéeICollection.CountInfrastructure. Obtient le nombre d'éléments contenus dans la collection StateManagedCollection. (Hérité de StateManagedCollection.)
Implémentation d'interface explicitePropriété privéeICollection.IsSynchronizedInfrastructure. 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.)
Implémentation d'interface explicitePropriété privéeICollection.SyncRootInfrastructure. 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.)
Implémentation d'interface expliciteMéthode privéeIEnumerable.GetEnumeratorInfrastructure. Retourne un itérateur qui itère au sein de la collection StateManagedCollection. (Hérité de StateManagedCollection.)
Implémentation d'interface expliciteMéthode privéeIList.AddAjoute un élément à la collection StateManagedCollection. (Hérité de StateManagedCollection.)
Implémentation d'interface expliciteMéthode privéeIList.ClearInfrastructure. Supprime tous les éléments de la collection StateManagedCollection. (Hérité de StateManagedCollection.)
Implémentation d'interface expliciteMéthode privéeIList.ContainsDétermine si la collection StateManagedCollection contient une valeur spécifique. (Hérité de StateManagedCollection.)
Implémentation d'interface expliciteMéthode privéeIList.IndexOfDétermine l'index d'un élément spécifié de la collection StateManagedCollection. (Hérité de StateManagedCollection.)
Implémentation d'interface expliciteMéthode privéeIList.InsertInsère un élément dans la collection StateManagedCollection à l'index spécifié. (Hérité de StateManagedCollection.)
Implémentation d'interface explicitePropriété privéeIList.IsFixedSizeInfrastructure. 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.)
Implémentation d'interface explicitePropriété privéeIList.IsReadOnlyInfrastructure. Obtient une valeur indiquant si la collection StateManagedCollection est en lecture seule. (Hérité de StateManagedCollection.)
Implémentation d'interface explicitePropriété privéeIList.ItemInfrastructure. Obtient l'élément IStateManager à l'index spécifié. (Hérité de StateManagedCollection.)
Implémentation d'interface expliciteMéthode privéeIList.RemoveSupprime la première occurrence de l'objet spécifié dans la collection StateManagedCollection. (Hérité de StateManagedCollection.)
Implémentation d'interface expliciteMéthode privéeIList.RemoveAtSupprime l'élément IStateManager au niveau de l'index spécifié. (Hérité de StateManagedCollection.)
Implémentation d'interface explicitePropriété privéeIStateManager.IsTrackingViewStateObtient une valeur indiquant si la collection StateManagedCollection enregistre les modifications apportées à son état d'affichage. (Hérité de StateManagedCollection.)
Implémentation d'interface expliciteMéthode privéeIStateManager.LoadViewStateRestaure l'état d'affichage précédemment enregistré de la collection StateManagedCollection et les éléments IStateManager qu'elle contient. (Hérité de StateManagedCollection.)
Implémentation d'interface expliciteMéthode privéeIStateManager.SaveViewStateEnregistre 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.)
Implémentation d'interface expliciteMéthode privéeIStateManager.TrackViewStateCommande à 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.)
Début

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 en sont dérivés.

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.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

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

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft