DataGridViewRow Classe

Définition

Représente une ligne dans un contrôle DataGridView.Represents a row in a DataGridView control.

public ref class DataGridViewRow : System::Windows::Forms::DataGridViewBand
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))]
public class DataGridViewRow : System.Windows.Forms.DataGridViewBand
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.The following code example illustrates the use of this type. Cet exemple fait partie d’un exemple plus complet disponible dans How à : Manipuler des lignes dans le Windows Formsde contrôle DataGridView.This example is part of a larger example available in 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 classe DataGridViewRow représente une ligne dans un contrôle DataGridView.The DataGridViewRow class represents a row in a DataGridView control. Vous pouvez récupérer des lignes via les collections Rows et SelectedRows du contrôle.You can retrieve rows through the Rows and SelectedRows collections of the control.

Contrairement à un DataGridViewColumn, un DataGridViewRow physiquement contient une collection de toutes les cellules de cette ligne.Unlike a DataGridViewColumn, a DataGridViewRow physically contains a collection of all of the cells in that row. Vous pouvez accéder à cette collection via la propriété Cells.You can access this collection through the Cells property.

La classe DataGridViewRow 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, tels que la hauteur et le style de cellule.The DataGridViewRow class is used to access the individual cell elements, as well as to adjust the appearance and behavior of the row user interface (UI), such as height and cell style. 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.Typically, you will want all rows or most rows in the control to share the same characteristics. 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 propriété DataGridView.RowsDefaultCellStyle.To set cell styles for all rows in the control, set the properties of the object returned by the DataGridView.RowsDefaultCellStyle property. Pour définir des styles pour les lignes en alternance, utilisez la propriété DataGridView.AlternatingRowsDefaultCellStyle.To set styles for alternating rows, use the DataGridView.AlternatingRowsDefaultCellStyle property. Pour plus d’informations sur les styles de cellules, consultez styles de cellule dans le contrôle DataGridView Windows Forms.For more information about cell styles, see Cell Styles in the Windows Forms DataGridView Control. Vous pouvez également utiliser la propriété DataGridView.RowTemplate pour définir une ligne qui sera utilisée comme base pour toutes les lignes ajoutées au contrôle.You can also use the DataGridView.RowTemplate property to define a row that will be used as a basis for all rows added to the control.

Le contrôle DataGridView partagera DataGridViewRow objets sur plusieurs lignes de données dans la mesure du possible, afin d’éviter des pénalités en matière de performances.The DataGridView control will share DataGridViewRow objects across multiple data rows whenever possible to avoid performance penalties. À moins que vous ne travailliez avec de grandes quantités de données et que vous rencontriez des problèmes de performances, vous pouvez généralement ignorer le partage de lignes.Unless you are working with large amounts of data and experiencing performance issues, you can typically ignore row sharing. Une ligne partagée est indiquée par une Index valeur de propriété de-1.A shared row is indicated by an Index property value of -1. Certains membres de la classe DataGridViewRow 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 propriété DataGridViewRowCollection.Item[Int32].Some members of the DataGridViewRow class cannot be used with shared rows, but you can unshare a row by accessing it through the DataGridViewRowCollection.Item[Int32] property. Les lignes peuvent également devenir non partagées d’une autre manière.Rows can also become unshared in other ways. Pour accéder à une ligne sans annuler son partage, utilisez la méthode DataGridViewRowCollection.SharedRow.To access a row without unsharing it, use the DataGridViewRowCollection.SharedRow method. Lorsque vous travaillez avec de grandes quantités de données, vous devez savoir comment les lignes sont partagées et non partagées pour éviter des pénalités en matière de performances.When working with large amounts of data, you should be aware of how rows are shared and unshared to avoid performance penalties. Pour plus d'informations, consultez Meilleures pratiques pour la mise à l'échelle du contrôle DataGridView Windows Forms.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

Notes pour les héritiers

Quand vous dérivez de DataGridViewRow et ajoutez de nouvelles propriétés à la classe dérivée, veillez à substituer la méthode Clone() pour copier les nouvelles propriétés lors des opérations de clonage.When you derive from DataGridViewRow and add new properties to the derived class, be sure to override the Clone() method to copy the new properties during cloning operations. Vous devez également appeler la méthode Clone() de la classe de base afin que les propriétés de la classe de base soient copiées dans la nouvelle cellule.You should also call the base class's Clone() method so that the properties of the base class are copied to the new cell.

Constructeurs

DataGridViewRow()

Initialise une nouvelle instance de la classe DataGridViewRow sans utiliser de modèle.Initializes a new instance of the DataGridViewRow class without using a template.

Propriétés

AccessibilityObject

Obtient le DataGridViewRow.DataGridViewRowAccessibleObject assigné à DataGridViewRow.Gets the DataGridViewRow.DataGridViewRowAccessibleObject assigned to the DataGridViewRow.

Cells

Obtient la collection de cellules qui remplissent la ligne.Gets the collection of cells that populate the row.

ContextMenuStrip

Obtient ou définit le menu contextuel pour la ligne.Gets or sets the shortcut menu for the row.

DataBoundItem

Obtient l'objet lié aux données qui a rempli la ligne.Gets the data-bound object that populated the row.

DataGridView

Obtient le contrôle DataGridView associé à cet élément.Gets the DataGridView control associated with this element.

(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.Gets or sets the default styles for the row, which are used to render cells in the row unless the styles are overridden.

DefaultHeaderCellType

Obtient ou définit le type à l'exécution de la cellule d'en-tête par défaut.Gets or sets the run-time type of the default header cell.

(Hérité de DataGridViewBand)
Displayed

Obtient une valeur indiquant si cette ligne est affichée sur l'écran.Gets a value indicating whether this row is displayed on the screen.

DividerHeight

Obtient ou définit la hauteur, en pixels, du séparateur de ligne.Gets or sets the height, in pixels, of the row divider.

ErrorText

Obtient ou définit le texte du message d'erreur pour les erreurs au niveau de la ligne.Gets or sets the error message text for row-level errors.

Frozen

Obtient ou définit une valeur indiquant si la ligne est figée.Gets or sets a value indicating whether the row is frozen.

HasDefaultCellStyle

Obtient une valeur indiquant si la propriété DefaultCellStyle a été définie.Gets a value indicating whether the DefaultCellStyle property has been set.

(Hérité de DataGridViewBand)
HeaderCell

Obtient ou définit la cellule d'en-tête de la ligne.Gets or sets the row's header cell.

HeaderCellCore

Obtient ou définit la cellule d'en-tête du DataGridViewBand.Gets or sets the header cell of the DataGridViewBand.

(Hérité de DataGridViewBand)
Height

Obtient ou définit la hauteur actuelle de la ligne.Gets or sets the current height of the row.

Index

Obtient la position relative de la bande dans le contrôle DataGridView.Gets the relative position of the band within the DataGridView control.

(Hérité de DataGridViewBand)
InheritedStyle

Obtient le style de cellule défini pour la ligne.Gets the cell style in effect for the row.

IsNewRow

Obtient une valeur qui indique si la ligne correspond à la ligne pour les nouveaux enregistrements.Gets a value indicating whether the row is the row for new records.

IsRow

Obtient une valeur indiquant si la bande représente une ligne.Gets a value indicating whether the band represents a row.

(Hérité de DataGridViewBand)
MinimumHeight

Obtient ou définit la hauteur minimale de la ligne.Gets or sets the minimum height of the row.

ReadOnly

Obtient ou définit une valeur indiquant si la ligne est en lecture seule.Gets or sets a value indicating whether the row is read-only.

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.Gets or sets a value indicating whether users can resize the row or indicating that the behavior is inherited from the AllowUserToResizeRows property.

Selected

Obtient ou définit une valeur indiquant si la ligne est sélectionnée.Gets or sets a value indicating whether the row is selected.

State

Obtient l'état actuel de la ligne.Gets the current state of the row.

Tag

Obtient ou définit l'objet qui contient les données à associer à la bande.Gets or sets the object that contains data to associate with the band.

(Hérité de DataGridViewBand)
Visible

Obtient ou définit une valeur indiquant si la ligne est visible.Gets or sets a value indicating whether the row is 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.Modifies an input row header border style according to the specified criteria.

Clone()

Crée une copie exacte de cette ligne.Creates an exact copy of this row.

CreateAccessibilityInstance()

Crée un objet accessible pour le DataGridViewRow.Creates a new accessible object for the DataGridViewRow.

CreateCells(DataGridView)

Efface les cellules existantes et définit leur modèle en fonction du modèle DataGridView fourni.Clears the existing cells and sets their template according to the supplied DataGridView template.

CreateCells(DataGridView, Object[])

Efface les cellules existantes et définit leur modèle et leurs valeurs.Clears the existing cells and sets their template and values.

CreateCellsInstance()

Construit une nouvelle collection de cellules basée sur cette ligne.Constructs a new collection of cells based on this row.

Dispose()

Libère toutes les ressources utilisées par DataGridViewBand.Releases all resources used by the 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.Releases the unmanaged resources used by the DataGridViewBand and optionally releases the managed resources.

(Hérité de DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)

Dessine un rectangle de focus autour des limites spécifiées.Draws a focus rectangle around the specified bounds.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetContextMenuStrip(Int32)

Obtient le menu contextuel pour la ligne.Gets the shortcut menu for the row.

GetErrorText(Int32)

Obtient le texte d'erreur pour la ligne à l'index spécifié.Gets the error text for the row at the specified index.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(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.Calculates the ideal height of the specified row based on the specified criteria.

GetState(Int32)

Retourne une valeur indiquant l'état actuel de la ligne.Returns a value indicating the current state of the row.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnDataGridViewChanged()

Appelé lorsque la bande est associée à un DataGridView différent.Called when the band is associated with a different DataGridView.

(Hérité de DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)

Peint la ligne actuelle.Paints the current row.

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

Peint les cellules dans la ligne actuelle.Paints the cells in the current row.

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

Peint l'en-tête de cellule de la ligne actuelle.Paints the header cell of the current row.

RaiseCellClick(DataGridViewCellEventArgs)

Déclenche l'événement CellClick.Raises the CellClick event.

(Hérité de DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

Déclenche l'événement CellContentClick.Raises the CellContentClick event.

(Hérité de DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Déclenche l'événement CellContentDoubleClick.Raises the CellContentDoubleClick event.

(Hérité de DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

Déclenche l'événement CellValueChanged.Raises the CellValueChanged event.

(Hérité de DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

Déclenche l'événement DataError.Raises the DataError event.

(Hérité de DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

Déclenche l'événement MouseWheel.Raises the MouseWheel event.

(Hérité de DataGridViewElement)
SetValues(Object[])

Définit les valeurs des cellules de la ligne.Sets the values of the row's cells.

ToString()

Obtient une chaîne, lisible par l'utilisateur, décrivant la ligne.Gets a human-readable string that describes the row.

S’applique à

Voir aussi