Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
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

DataGridViewRow, classe

Représente une ligne dans un contrôle DataGridView.

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

public class DataGridViewRow : DataGridViewBand

Le type DataGridViewRow expose les membres suivants.

  NomDescription
Méthode publiqueDataGridViewRowInitialise une nouvelle instance de la classe DataGridViewRow sans utiliser de modèle.
Début

  NomDescription
Propriété publiqueAccessibilityObjectObtient le DataGridViewRow.DataGridViewRowAccessibleObject assigné à DataGridViewRow.
Propriété publiqueCellsObtient la collection de cellules qui remplissent la ligne.
Propriété publiqueContextMenuStripObtient ou définit le menu contextuel pour la ligne. (Substitue DataGridViewBand.ContextMenuStrip.)
Propriété publiqueDataBoundItemObtient l'objet lié aux données qui a rempli la ligne.
Propriété publiqueDataGridViewObtient le contrôle DataGridView associé à cet élément. (Hérité de DataGridViewElement.)
Propriété publiqueDefaultCellStyleObtient ou définit les styles par défaut de la ligne, qui sont utilisés pour restituer les cellules de la ligne à moins que les styles soient substitués. (Substitue DataGridViewBand.DefaultCellStyle.)
Propriété publiqueDefaultHeaderCellTypeObtient ou définit le type à l'exécution de la cellule d'en-tête par défaut. (Hérité de DataGridViewBand.)
Propriété publiqueDisplayedObtient une valeur indiquant si cette ligne est affichée sur l'écran. (Substitue DataGridViewBand.Displayed.)
Propriété publiqueDividerHeightObtient ou définit la hauteur, en pixels, du séparateur de ligne.
Propriété publiqueErrorTextObtient ou définit le texte du message d'erreur pour les erreurs au niveau de la ligne.
Propriété publiqueFrozenObtient ou définit une valeur indiquant si la ligne est figée. (Substitue DataGridViewBand.Frozen.)
Propriété publiqueHasDefaultCellStyleObtient une valeur indiquant si la propriété DefaultCellStyle a été définie. (Hérité de DataGridViewBand.)
Propriété publiqueHeaderCellObtient ou définit la cellule d'en-tête de la ligne.
Propriété protégéeHeaderCellCoreObtient ou définit la cellule d'en-tête du DataGridViewBand. (Hérité de DataGridViewBand.)
Propriété publiqueHeightObtient ou définit la hauteur actuelle de la ligne.
Propriété publiqueIndexObtient la position relative de la bande dans le contrôle DataGridView. (Hérité de DataGridViewBand.)
Propriété publiqueInheritedStyleObtient le style de cellule défini pour la ligne. (Substitue DataGridViewBand.InheritedStyle.)
Propriété publiqueIsNewRowObtient une valeur qui indique si la ligne correspond à la ligne pour les nouveaux enregistrements.
Propriété protégéeIsRowObtient une valeur indiquant si la bande représente une ligne. (Hérité de DataGridViewBand.)
Propriété publiqueMinimumHeightObtient ou définit la hauteur minimale de la ligne.
Propriété publiqueReadOnlyObtient ou définit une valeur indiquant si la ligne est en lecture seule. (Substitue DataGridViewBand.ReadOnly.)
Propriété publiqueResizableObtient ou définit une valeur indiquant si les utilisateurs peuvent redimensionner la ligne ou si le comportement est hérité de la propriété DataGridView.AllowUserToResizeRows. (Substitue DataGridViewBand.Resizable.)
Propriété publiqueSelectedObtient ou définit une valeur indiquant si la ligne est sélectionnée. (Substitue DataGridViewBand.Selected.)
Propriété publiqueStateObtient l'état actuel de la ligne. (Substitue DataGridViewElement.State.)
Propriété publiqueTagObtient ou définit l'objet qui contient les données à associer à la bande. (Hérité de DataGridViewBand.)
Propriété publiqueVisibleObtient ou définit une valeur indiquant si la ligne est visible. (Substitue DataGridViewBand.Visible.)
Début

  NomDescription
Méthode publiqueAdjustRowHeaderBorderStyleModifie le style de bordure d'en-tête de ligne d'entrée en fonction des critères spécifiés.
Méthode publiqueCloneCrée une copie exacte de cette ligne. (Substitue DataGridViewBand.Clone().)
Méthode protégéeCreateAccessibilityInstanceCrée un nouvel objet accessible pour DataGridViewRow.
Méthode publiqueCreateCells(DataGridView)Efface les cellules existantes et définit leur modèle en fonction du modèle DataGridView fourni.
Méthode publiqueCreateCells(DataGridView, Object[])Efface les cellules existantes et définit leur modèle et leurs valeurs.
Méthode protégéeCreateCellsInstanceConstruit une nouvelle collection de cellules basée sur cette ligne.
Méthode publiqueDispose()Libère toutes les ressources utilisées par DataGridViewBand. (Hérité de DataGridViewBand.)
Méthode protégéeDispose(Boolean)Libère les ressources non managées utilisées par DataGridViewBand et libère éventuellement les ressources managées. (Hérité de DataGridViewBand.)
Méthode protégéeDrawFocusDessine un rectangle de focus autour des limites spécifiées.
Méthode publiqueEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéeFinalizeLibère les ressources associées à cette bande. (Hérité de DataGridViewBand.)
Méthode publiqueGetContextMenuStripObtient le menu contextuel pour la ligne.
Méthode publiqueGetErrorTextObtient le texte d'erreur pour la ligne à l'index spécifié.
Méthode publiqueGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetPreferredHeightCalcule la hauteur idéale de la ligne spécifiée en fonction des critères spécifiés.
Méthode publiqueGetStateRetourne une valeur indiquant l'état actuel de la ligne.
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégéeOnDataGridViewChangedAppelé lorsque la bande est associée à un DataGridView différent. (Hérité de DataGridViewBand.)
Méthode protégéePaintPeint la ligne actuelle.
Méthode protégéePaintCellsPeint les cellules dans la ligne actuelle.
Méthode protégéePaintHeaderPeint l'en-tête de cellule de la ligne actuelle.
Méthode protégéeRaiseCellClickDéclenche l'événement DataGridView.CellClick. (Hérité de DataGridViewElement.)
Méthode protégéeRaiseCellContentClickDéclenche l'événement DataGridView.CellContentClick. (Hérité de DataGridViewElement.)
Méthode protégéeRaiseCellContentDoubleClickDéclenche l'événement DataGridView.CellContentDoubleClick. (Hérité de DataGridViewElement.)
Méthode protégéeRaiseCellValueChangedDéclenche l'événement DataGridView.CellValueChanged. (Hérité de DataGridViewElement.)
Méthode protégéeRaiseDataErrorDéclenche l'événement DataGridView.DataError. (Hérité de DataGridViewElement.)
Méthode protégéeRaiseMouseWheelDéclenche l'événement Control.MouseWheel. (Hérité de DataGridViewElement.)
Méthode publiqueSetValuesDéfinit les valeurs des cellules de la ligne.
Méthode publiqueToStringObtient une chaîne, lisible par l'utilisateur, décrivant la ligne. (Substitue DataGridViewBand.ToString().)
Début

La classe DataGridViewRow représente une ligne dans un contrôle DataGridView. Vous pouvez récupérer des lignes par l'intermédiaire des collections Rows et SelectedRows du contrôle.

Contrairement à DataGridViewColumn, DataGridViewRow contient physiquement une collection de toutes les cellules de cette ligne. Vous pouvez accéder à cette collection via la propriété Cells.

La classe DataGridViewRow est utilisée pour accéder aux éléments de cellule, mais également pour modifier l'apparence et le comportement de l'interface utilisateur de la ligne, par exemple la hauteur et le style de cellule. En général, vous souhaitez que toutes les lignes ou la plupart des lignes du contrôle partagent les mêmes caractéristiques. Pour définir des styles de cellule pour toutes les lignes du contrôle, définissez les propriétés de l'objet retourné par la propriété DataGridView.RowsDefaultCellStyle. Pour définir des styles pour les lignes en alternance, utilisez la propriété DataGridView.AlternatingRowsDefaultCellStyle. Pour plus d'informations sur les styles des cellules, consultez Styles de cellules dans le contrôle DataGridView Windows Forms. Vous pouvez également utiliser la propriété DataGridView.RowTemplate pour définir une ligne qui sert de base pour toutes les lignes ajoutées au contrôle.

Le contrôle DataGridView partage des objets DataGridViewRow sur plusieurs lignes de données, si possible, afin d'éviter une altération des performances. Sauf si vous utilisez de grandes quantités de données et si vous rencontrez des problèmes de performances, vous pouvez généralement ignorer le partage de lignes. Une ligne partagée est indiquée par une valeur de propriété Index de -1. Certains membres de la classe DataGridViewRow ne peuvent pas être utilisés avec des lignes partagées, mais vous pouvez annuler le partage d'une ligne en y accédant par l'intermédiaire de la propriété DataGridViewRowCollection.Item. Les lignes peuvent également devenir non partagées en utilisant d'autres méthodes. Pour accéder à une ligne sans annuler son partage, utilisez la méthode DataGridViewRowCollection.SharedRow. Lorsque vous utilisez de grandes quantités de données, vous devez connaître le mode de partage et d'annulation de partage des lignes pour éviter une altération des performances. Pour plus d'informations, consultez Meilleures pratiques pour la mise à l'échelle du contrôle DataGridView Windows Forms.

Remarques à l'attention des héritiers

Lorsque vous effectuez une dérivation à partir de DataGridViewRow et que vous ajoutez de nouvelles propriétés à la classe dérivée, veillez à substituer la méthode Clone pour copier les nouvelles propriétés au cours des opérations de clonage. Vous devez également appeler la méthode Clone de la classe de base afin que les propriétés de cette classe de base soient copiées dans la nouvelle cellule.

L'exemple de code suivant illustre l'utilisation de ce type. Cet exemple est extrait d'un exemple plus développé disponible dans Comment : manipuler les lignes du contrôle DataGridView Windows Forms.


// Set row labels.
private void Button6_Click(object sender, System.EventArgs e)
{

    int rowNumber = 1;
    foreach (DataGridViewRow row in dataGridView.Rows)
    {
        if (row.IsNewRow) continue;
        row.HeaderCell.Value = "Row " + rowNumber;
        rowNumber = rowNumber + 1;
    }
    dataGridView.AutoResizeRowHeadersWidth(
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}


.NET Framework

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

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

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