Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DataGridViewRow classe

 

Date de publication : novembre 2016

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

Espace de noms:   System.Windows.Forms
Assembly:  System.Windows.Forms (dans System.Windows.Forms.dll)


public class DataGridViewRow : DataGridViewBand

NomDescription
System_CAPS_pubmethodDataGridViewRow()

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

NomDescription
System_CAPS_pubpropertyAccessibilityObject

Obtient le DataGridViewRow.DataGridViewRowAccessibleObject affectée à la DataGridViewRow.

System_CAPS_pubpropertyCells

Obtient la collection de cellules qui remplissent la ligne.

System_CAPS_pubpropertyContextMenuStrip

Obtient ou définit le menu contextuel pour la ligne.(Remplace DataGridViewBand.ContextMenuStrip.)

System_CAPS_pubpropertyDataBoundItem

Obtient l'objet lié aux données qui a rempli la ligne.

System_CAPS_pubpropertyDataGridView

Obtient le DataGridView contrôle associé à cet élément.(Hérité de DataGridViewElement.)

System_CAPS_pubpropertyDefaultCellStyle

Obtient ou définit les styles par défaut pour la ligne, qui sont utilisés pour restituer les cellules de la ligne à moins que les styles soient substitués.(Remplace DataGridViewBand.DefaultCellStyle.)

System_CAPS_pubpropertyDefaultHeaderCellType

Obtient ou définit le type d’exécution de la cellule d’en-tête par défaut.(Hérité de DataGridViewBand.)

System_CAPS_pubpropertyDisplayed

Obtient une valeur indiquant si cette ligne est affichée sur l'écran.(Remplace DataGridViewBand.Displayed.)

System_CAPS_pubpropertyDividerHeight

Obtient ou définit la hauteur, en pixels, du séparateur de ligne.

System_CAPS_pubpropertyErrorText

Obtient ou définit le texte du message d'erreur pour les erreurs au niveau de la ligne.

System_CAPS_pubpropertyFrozen

Obtient ou définit une valeur indiquant si la ligne est figée.(Remplace DataGridViewBand.Frozen.)

System_CAPS_pubpropertyHasDefaultCellStyle

Obtient une valeur indiquant si le DefaultCellStyle propriété a été définie.(Hérité de DataGridViewBand.)

System_CAPS_pubpropertyHeaderCell

Obtient ou définit la cellule d'en-tête de la ligne.

System_CAPS_protpropertyHeaderCellCore

Obtient ou définit la cellule d’en-tête de la DataGridViewBand.(Hérité de DataGridViewBand.)

System_CAPS_pubpropertyHeight

Obtient ou définit la hauteur actuelle de la ligne.

System_CAPS_pubpropertyIndex

Obtient la position relative de la bande dans la DataGridView contrôle.(Hérité de DataGridViewBand.)

System_CAPS_pubpropertyInheritedStyle

Obtient le style de cellule défini pour la ligne.(Remplace DataGridViewBand.InheritedStyle.)

System_CAPS_pubpropertyIsNewRow

Obtient une valeur qui indique si la ligne correspond à la ligne pour les nouveaux enregistrements.

System_CAPS_protpropertyIsRow

Obtient une valeur indiquant si la bande représente une ligne.(Hérité de DataGridViewBand.)

System_CAPS_pubpropertyMinimumHeight

Obtient ou définit la hauteur minimale de la ligne.

System_CAPS_pubpropertyReadOnly

Obtient ou définit une valeur indiquant si la ligne est en lecture seule.(Remplace DataGridViewBand.ReadOnly.)

System_CAPS_pubpropertyResizable

Obtient ou définit une valeur indiquant si les utilisateurs peuvent redimensionner la ligne ou que le comportement est hérité de le DataGridView.AllowUserToResizeRows propriété.(Remplace DataGridViewBand.Resizable.)

System_CAPS_pubpropertySelected

Obtient ou définit une valeur indiquant si la ligne est sélectionnée.(Remplace DataGridViewBand.Selected.)

System_CAPS_pubpropertyState

Obtient l'état actuel de la ligne.(Remplace DataGridViewElement.State.)

System_CAPS_pubpropertyTag

Obtient ou définit l’objet qui contient les données à associer à la bande.(Hérité de DataGridViewBand.)

System_CAPS_pubpropertyVisible

Obtient ou définit une valeur indiquant si la ligne est visible.(Remplace DataGridViewBand.Visible.)

NomDescription
System_CAPS_pubmethodAdjustRowHeaderBorderStyle(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.

System_CAPS_pubmethodClone()

Crée une copie exacte de cette ligne.(Remplace DataGridViewBand.Clone().)

System_CAPS_protmethodCreateAccessibilityInstance()

Crée un objet accessible pour le DataGridViewRow.

System_CAPS_pubmethodCreateCells(DataGridView)

Efface les cellules existantes et définit leur modèle en fonction de l’élément DataGridView modèle.

System_CAPS_pubmethodCreateCells(DataGridView, Object[])

Efface les cellules existantes et définit leur modèle et leurs valeurs.

System_CAPS_protmethodCreateCellsInstance()

Construit une nouvelle collection de cellules basée sur cette ligne.

System_CAPS_pubmethodDispose()

Libère toutes les ressources utilisées par DataGridViewBand.(Hérité de DataGridViewBand.)

System_CAPS_protmethodDispose(Boolean)

Libère les ressources non managées utilisées par DataGridViewBand et libère éventuellement les ressources managées.(Hérité de DataGridViewBand.)

System_CAPS_protmethodDrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)

Dessine un rectangle de focus autour des limites spécifiées.

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Libère les ressources associées à la bande.(Hérité de DataGridViewBand.)

System_CAPS_pubmethodGetContextMenuStrip(Int32)

Obtient le menu contextuel pour la ligne.

System_CAPS_pubmethodGetErrorText(Int32)

Obtient le texte d'erreur pour la ligne à l'index spécifié.

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)

Calcule la hauteur idéale de la ligne spécifiée en fonction des critères spécifiés.

System_CAPS_pubmethodGetState(Int32)

Retourne une valeur indiquant l'état actuel de la ligne.

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnDataGridViewChanged()

Appelé lorsque la bande est associé à un autre DataGridView.(Hérité de DataGridViewBand.)

System_CAPS_protmethodPaint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)

Peint la ligne actuelle.

System_CAPS_protmethodPaintCells(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)

Peint les cellules dans la ligne actuelle.

System_CAPS_protmethodPaintHeader(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)

Peint l'en-tête de cellule de la ligne actuelle.

System_CAPS_protmethodRaiseCellClick(DataGridViewCellEventArgs)

Déclenche l'événement DataGridView.CellClick.(Hérité de DataGridViewElement.)

System_CAPS_protmethodRaiseCellContentClick(DataGridViewCellEventArgs)

Déclenche l'événement DataGridView.CellContentClick.(Hérité de DataGridViewElement.)

System_CAPS_protmethodRaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Déclenche l'événement DataGridView.CellContentDoubleClick.(Hérité de DataGridViewElement.)

System_CAPS_protmethodRaiseCellValueChanged(DataGridViewCellEventArgs)

Déclenche l'événement DataGridView.CellValueChanged.(Hérité de DataGridViewElement.)

System_CAPS_protmethodRaiseDataError(DataGridViewDataErrorEventArgs)

Déclenche l'événement DataGridView.DataError.(Hérité de DataGridViewElement.)

System_CAPS_protmethodRaiseMouseWheel(MouseEventArgs)

Déclenche l'événement Control.MouseWheel.(Hérité de DataGridViewElement.)

System_CAPS_pubmethodSetValues(Object[])

Définit les valeurs des cellules de la ligne.

System_CAPS_pubmethodToString()

Obtient une chaîne, lisible par l'utilisateur, décrivant la ligne.(Remplace DataGridViewBand.ToString().)

La DataGridViewRow classe représente une ligne dans un DataGridView contrôle. Vous pouvez récupérer des lignes par le biais du Rows et SelectedRows collections 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, aussi bien pour modifier l’apparence et le comportement de l’interface utilisateur de ligne (UI), comme style de cellule et de hauteur. 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 cellules pour toutes les lignes dans le 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 en alternance, utilisez la DataGridView.AlternatingRowsDefaultCellStyle propriété. Pour plus d’informations sur les styles de cellules, consultez Styles de cellules dans le contrôle DataGridView Windows Forms. Vous pouvez également utiliser le DataGridView.RowTemplate propriété à définir une ligne qui servira de base pour toutes les lignes ajoutées au contrôle.

Le DataGridView contrôle partageront DataGridViewRow objets à travers plusieurs lignes de données que possible pour éviter de trop handicaper les performances. Sauf si vous travaillez avec de grandes quantités de données et rencontrant 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 peut pas être utilisée avec des lignes partagées, mais vous pouvez annuler le partage d’une ligne en y accédant via le DataGridViewRowCollection.Item propriété. Lignes peuvent également devenir non partagées par d’autres moyens. Pour accéder à une ligne sans annuler son partage, utilisez le DataGridViewRowCollection.SharedRow (méthode). Lorsque vous travaillez avec de grandes quantités de données, vous devez connaître comment les lignes sont partagées et non partagées pour éviter de trop handicaper les performances. Pour plus d'informations, consultez Meilleures pratiques pour la mise à l'échelle du contrôle DataGridView Windows Forms.

Remarques à l’attention des héritiers :

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

L’exemple de code suivant illustre l’utilisation de ce type. Cet exemple fait partie 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);
}

.NET Framework
Disponible depuis 2.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: