DataGridViewRow Classe

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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

DataGridViewRow()

Initialise une nouvelle instance de la classe DataGridViewRow sans utiliser de modèle.

Propriétés

AccessibilityObject	Obtient le DataGridViewRow.DataGridViewRowAccessibleObject assigné à DataGridViewRow.
Cells	Obtient la collection de cellules qui remplissent la ligne.
ContextMenuStrip	Obtient ou définit le menu contextuel pour la ligne.
DataBoundItem	Obtient l'objet lié aux données qui a rempli la ligne.
DataGridView	Obtient le contrôle DataGridView 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 restituer les cellules de la ligne à moins que les styles soient substitués.
DefaultHeaderCellType	Obtient ou définit le type à l'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 sur l'écran.
DividerHeight	Obtient ou définit la hauteur, en pixels, du séparateur de ligne.
ErrorText	Obtient ou définit le texte du message d'erreur pour les erreurs au niveau de la ligne.
Frozen	Obtient ou définit une valeur indiquant si la ligne est figée.
HasDefaultCellStyle	Obtient une valeur indiquant si la propriété DefaultCellStyle 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 contrôle DataGridView. (Hérité de DataGridViewBand)
InheritedStyle	Obtient le style de cellule défini pour la ligne.
IsNewRow	Obtient une valeur qui indique si la ligne correspond à la ligne pour les 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 si le comportement est hérité de la propriété AllowUserToResizeRows.
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 les données à associer à la bande. (Hérité de DataGridViewBand)
Visible	Obtient ou définit une valeur indiquant si la ligne est visible.

Méthodes

AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Modifie le 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)	Efface les cellules existantes et définit leur modèle en fonction du modèle DataGridView fourni.
CreateCells(DataGridView, Object[])	Efface les cellules existantes et définit leur modèle et leurs valeurs.
CreateCellsInstance()	Construit une nouvelle collection de cellules basée sur cette ligne.
Dispose()	Libère toutes les ressources utilisées par DataGridViewBand. (Hérité de DataGridViewBand)
Dispose(Boolean)	Libère les ressources non managées utilisées par DataGridViewBand 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.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetContextMenuStrip(Int32)	Obtient le menu contextuel pour la ligne.
GetErrorText(Int32)	Obtient le texte d'erreur pour la ligne à l'index spécifié.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
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.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnDataGridViewChanged()	Appelé lorsque la bande est associée à un DataGridView différent. (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 dans la ligne actuelle.
PaintHeader(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)	Peint l'en-tête de cellule de la ligne actuelle.
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'utilisateur, décrivant la ligne.

S’applique à