Cette documentation est archivée et n’est pas conservée.

DataGridViewRow, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

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
public class DataGridViewRow extends DataGridViewBand
public class DataGridViewRow extends DataGridViewBand

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 de cellule, 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 Méthodes conseillées 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);
}

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Prise en charge dans : 2.0
Afficher: