Partager via


DataGridViewRow Classe

Définition

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
Attributs

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 à

Voir aussi