DataGridViewRow Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

DataGridViewRow.cs

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

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 in the Windows Forms DataGridView Control.

// 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 collections et SelectedRows les Rows collections du contrôle.

Contrairement à un DataGridViewColumn, un DataGridViewRow objet 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, telles que 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 partagera DataGridViewRow des objets sur plusieurs lignes de données chaque fois que cela est possible pour éviter les pénalités de performances. Sauf si vous travaillez avec 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és d’une autre manière. Pour accéder à une ligne sans le partage, utilisez la DataGridViewRowCollection.SharedRow méthode. Lorsque vous utilisez de grandes quantités de données, vous devez savoir comment les lignes sont partagées et non partagées pour éviter les pénalités de performances. Pour plus d’informations, consultez Les 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

Nom	Description
DataGridViewRow()	Initialise une nouvelle instance de la DataGridViewRow classe sans utiliser de modèle.

Propriétés

Nom	Description
AccessibilityObject	Obtient l’objet affecté à l’objet DataGridViewRow.DataGridViewRowAccessibleObjectDataGridViewRow.
Cells	Obtient la collection de cellules qui remplissent la ligne.
ContextMenuStrip	Obtient ou définit le menu contextuel de la ligne.
DataBoundItem	Obtient l’objet lié aux données qui a rempli la ligne.
DataGridView	Obtient le DataGridView contrôle associé à cet élément. (Hérité de DataGridViewElement)
DefaultCellStyle	Obtient ou définit les styles par défaut de la ligne, qui sont utilisés pour afficher les cellules de la ligne, sauf si les styles sont substitués.
DefaultHeaderCellType	Obtient ou définit le type d’exécution de la cellule d’en-tête par défaut. (Hérité de DataGridViewBand)
Displayed	Obtient une valeur indiquant si cette ligne est affichée à l’écran.
DividerHeight	Obtient ou définit la hauteur, en pixels, du séparateur de lignes.
ErrorText	Obtient ou définit le texte du message d’erreur pour les erreurs au niveau des lignes.
Frozen	Obtient ou définit une valeur indiquant si la ligne est figée.
HasDefaultCellStyle	Obtient une valeur indiquant si la DefaultCellStyle propriété a été définie. (Hérité de DataGridViewBand)
HeaderCell	Obtient ou définit la cellule d’en-tête de la ligne.
HeaderCellCore	Obtient ou définit la cellule d’en-tête du DataGridViewBand. (Hérité de DataGridViewBand)
Height	Obtient ou définit la hauteur actuelle de la ligne.
Index	Obtient la position relative de la bande dans le DataGridView contrôle. (Hérité de DataGridViewBand)
InheritedStyle	Obtient le style de cellule en vigueur pour la ligne.
IsNewRow	Obtient une valeur indiquant si la ligne est la ligne des nouveaux enregistrements.
IsRow	Obtient une valeur indiquant si la bande représente une ligne. (Hérité de DataGridViewBand)
MinimumHeight	Obtient ou définit la hauteur minimale de la ligne.
ReadOnly	Obtient ou définit une valeur indiquant si la ligne est en lecture seule.
Resizable	Obtient ou définit une valeur indiquant si les utilisateurs peuvent redimensionner la ligne ou indiquer que le comportement est hérité de la AllowUserToResizeRows propriété.
Selected	Obtient ou définit une valeur indiquant si la ligne est sélectionnée.
State	Obtient l’état actuel de la ligne.
Tag	Obtient ou définit l’objet qui contient des données à associer à la bande. (Hérité de DataGridViewBand)
Visible	Obtient ou définit une valeur indiquant si la ligne est visible.

Méthodes

Nom	Description
AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Modifie un style de bordure d’en-tête de ligne d’entrée en fonction des critères spécifiés.
Clone()	Crée une copie exacte de cette ligne.
CreateAccessibilityInstance()	Crée un objet accessible pour le DataGridViewRow.
CreateCells(DataGridView, Object[])	Efface les cellules existantes et définit leur modèle et leurs valeurs.
CreateCells(DataGridView)	Efface les cellules existantes et définit leur modèle en fonction du modèle fourni DataGridView .
CreateCellsInstance()	Construit une nouvelle collection de cellules basée sur cette ligne.
Dispose()	Libère toutes les ressources utilisées par le DataGridViewBand. (Hérité de DataGridViewBand)
Dispose(Boolean)	Libère les ressources non managées utilisées par les DataGridViewBand ressources gérées et libère éventuellement les ressources managées. (Hérité de DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)	Dessine un rectangle de focus autour des limites spécifiées.
GetContextMenuStrip(Int32)	Obtient le menu contextuel de la ligne.
GetErrorText(Int32)	Obtient le texte d’erreur de la ligne à l’index spécifié.
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)	Calcule la hauteur idéale de la ligne spécifiée en fonction des critères spécifiés.
GetState(Int32)	Retourne une valeur indiquant l’état actuel de la ligne.
OnDataGridViewChanged()	Appelé lorsque la bande est associée à un autre DataGridView. (Hérité de DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)	Peint la ligne actuelle.
PaintCells(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)	Peint les cellules de la ligne active.
PaintHeader(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)	Peint la cellule d’en-tête de la ligne active.
RaiseCellClick(DataGridViewCellEventArgs)	Déclenche l’événement CellClick. (Hérité de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Déclenche l’événement CellContentClick. (Hérité de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Déclenche l’événement CellContentDoubleClick. (Hérité de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Déclenche l’événement CellValueChanged. (Hérité de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Déclenche l’événement DataError. (Hérité de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Déclenche l’événement MouseWheel. (Hérité de DataGridViewElement)
SetValues(Object[])	Définit les valeurs des cellules de la ligne.
ToString()	Obtient une chaîne lisible par l’homme qui décrit la ligne.

Voir aussi

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