DataGridViewRow Classe

Définition

public ref class DataGridViewRow : System::Windows::Forms::DataGridViewBand

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))]
public class DataGridViewRow : System.Windows.Forms.DataGridViewBand

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))>]
type DataGridViewRow = class
    inherit DataGridViewBand

Public Class DataGridViewRow
Inherits DataGridViewBand

Héritage

Object

DataGridViewElement

DataGridViewBand

DataGridViewRow

Attributs

TypeConverterAttribute

Exemples

L’exemple de code suivant illustre l’utilisation de ce type. Cet exemple fait partie d’un exemple plus large disponible dans How to : Manipulate Rows dans le contrôle DataGridView Windows Forms.

// Set row labels.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{

   int rowNumber = 1;
   System::Collections::IEnumerator^ myEnum = safe_cast<System::Collections::IEnumerable^>(dataGridView->Rows)->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DataGridViewRow^ row = safe_cast<DataGridViewRow^>(myEnum->Current);
      if ( row->IsNewRow )
               continue;
      row->HeaderCell->Value = String::Format( L"Row {0}", rowNumber );

      rowNumber = rowNumber + 1;
   }

   dataGridView->AutoResizeRowHeadersWidth( DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders );
}

// 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);
}

' Set row labels.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim rowNumber As Integer = 1
    For Each row As DataGridViewRow In dataGridView.Rows
        If row.IsNewRow Then Continue For
        row.HeaderCell.Value = "Row " & rowNumber
        rowNumber = rowNumber + 1
    Next
    dataGridView.AutoResizeRowHeadersWidth( _
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)
End Sub

Remarques

La DataGridViewRow classe représente une ligne dans un DataGridView contrôle. Vous pouvez récupérer des lignes via les Rows collections et SelectedRows du contrôle.

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

La DataGridViewRow classe est utilisée pour accéder aux éléments de cellule individuels, ainsi que pour ajuster l’apparence et le comportement de l’interface utilisateur de ligne, comme la hauteur et le style de cellule. En règle générale, vous souhaiterez 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 DataGridView.RowsDefaultCellStyle propriété . Pour définir des styles pour les lignes alternées, utilisez la DataGridView.AlternatingRowsDefaultCellStyle propriété . Pour plus d’informations sur les styles de cellule, consultez Styles de cellule dans le contrôle DataGridView Windows Forms. Vous pouvez également utiliser la DataGridView.RowTemplate propriété pour définir une ligne qui sera utilisée comme base pour toutes les lignes ajoutées au contrôle.

Le DataGridView contrôle partage DataGridViewRow des objets sur plusieurs lignes de données chaque fois que possible pour éviter les pénalités de performances. Sauf si vous utilisez de grandes quantités de données et que 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 Index valeur de propriété de -1. Certains membres de la DataGridViewRow classe ne peuvent pas être utilisés avec des lignes partagées, mais vous pouvez annuler le partage d’une ligne en y accédant via la DataGridViewRowCollection.Item[] propriété . Les lignes peuvent également devenir non partagées d’autres manières. Pour accéder à une ligne sans la dissocier, utilisez la DataGridViewRowCollection.SharedRow méthode . Lorsque vous travaillez avec de grandes quantités de données, vous devez être conscient de la façon dont les lignes sont partagées et non partagées pour éviter les pénalités de performances. Pour plus d'informations, consultez Meilleures pratiques pour la mise à l'échelle du contrôle DataGridView Windows Forms.

Notes pour les héritiers

Lorsque vous dérivez et ajoutez de DataGridViewRow nouvelles propriétés à la classe dérivée, veillez à remplacer la Clone() méthode pour copier les nouvelles propriétés pendant les opérations de clonage. Vous devez également appeler la méthode de la classe de Clone() base afin que les propriétés de la classe de base soient copiées dans la nouvelle cellule.

Constructeurs

Propriétés

Méthodes

S’applique à

Voir aussi

• DataGridView
• DataGridViewColumn
• Clone()
• Meilleures pratiques pour la mise à l'échelle du contrôle DataGridView Windows Forms
• Styles de cellules dans le contrôle DataGridView Windows Forms