DataGridView.RowCount Propriété

Définition

Obtient ou définit le nombre de lignes affichées dans le DataGridView.Gets or sets the number of rows displayed in the DataGridView.

public:
 property int RowCount { int get(); void set(int value); };
[System.ComponentModel.Browsable(false)]
public int RowCount { get; set; }
member this.RowCount : int with get, set
Public Property RowCount As Integer

Valeur de propriété

Nombre de lignes à afficher dans le DataGridView.The number of rows to display in the DataGridView.

Attributs

Exceptions

La valeur spécifiée au moment de la définition de cette propriété est inférieure à 0.The specified value when setting this property is less than 0.

- ou --or- La valeur spécifiée est inférieure à 1 et AllowUserToAddRows est définie sur true.The specified value is less than 1 and AllowUserToAddRows is set to true.

Lorsque vous définissez cette propriété, la propriété DataSource est définie.When setting this property, the DataSource property is set.

Exemples

L’exemple de code suivant illustre l’utilisation de la propriété RowCount.The following code example demonstrates the use of the RowCount property. Dans cet exemple, cette propriété est utilisée pour effectuer le suivi du nombre d’entrées dans un DataGridView.In this example, this property is used to track the number of entries in a DataGridView. Cet exemple fait partie d’un exemple plus complet disponible dans l’événement SelectionChanged.This example is part of a larger example available in the SelectionChanged event.

private void UpdateLabelText()
{
    int WithdrawalTotal = 0;
    int DepositTotal = 0;
    int SelectedCellTotal = 0;
    int counter;

    // Iterate through all the rows and sum up the appropriate columns.
    for (counter = 0; counter < (DataGridView1.Rows.Count);
        counter++)
    {
        if (DataGridView1.Rows[counter].Cells["Withdrawals"].Value
            != null)
        {
            if (DataGridView1.Rows[counter].
                Cells["Withdrawals"].Value.ToString().Length != 0)
            {
                WithdrawalTotal += int.Parse(DataGridView1.Rows[counter].
                    Cells["Withdrawals"].Value.ToString());
            }
        }

        if (DataGridView1.Rows[counter].Cells["Deposits"].Value != null)
        {
            if (DataGridView1.Rows[counter]
                .Cells["Deposits"].Value.ToString().Length != 0)
            {
                DepositTotal += int.Parse(DataGridView1.Rows[counter]
                    .Cells["Deposits"].Value.ToString());
            }
        }
    }

    // Iterate through the SelectedCells collection and sum up the values.
    for (counter = 0;
        counter < (DataGridView1.SelectedCells.Count); counter++)
    {
        if (DataGridView1.SelectedCells[counter].FormattedValueType ==
            Type.GetType("System.String"))
        {
            string value = null;

            // If the cell contains a value that has not been commited,
            // use the modified value.
            if (DataGridView1.IsCurrentCellDirty == true)
            {

                value = DataGridView1.SelectedCells[counter]
                    .EditedFormattedValue.ToString();
            }
            else
            {
                value = DataGridView1.SelectedCells[counter]
                    .FormattedValue.ToString();
            }
            if (value != null)
            {
                // Ignore cells in the Description column.
                if (DataGridView1.SelectedCells[counter].ColumnIndex !=
                    DataGridView1.Columns["Description"].Index)
                {
                    if (value.Length != 0)
                    {
                        SelectedCellTotal += int.Parse(value);
                    }
                }
            }
        }
    }

    // Set the labels to reflect the current state of the DataGridView.
    Label1.Text = "Withdrawals Total: " + WithdrawalTotal.ToString();
    Label2.Text = "Deposits Total: " + DepositTotal.ToString();
    Label3.Text = "Selected Cells Total: " + SelectedCellTotal.ToString();
    Label4.Text = "Total entries: " + DataGridView1.RowCount.ToString();
}
Private Sub UpdateLabelText()
    Dim WithdrawalTotal As Integer = 0
    Dim DepositTotal As Integer = 0
    Dim SelectedCellTotal As Integer = 0
    Dim counter As Integer

    ' Iterate through all the rows and sum up the appropriate columns.
    For counter = 0 To (DataGridView1.Rows.Count - 1)
        If Not DataGridView1.Rows(counter) _
            .Cells("Withdrawals").Value Is Nothing Then

            If Not DataGridView1.Rows(counter) _
                .Cells("Withdrawals").Value.ToString().Length = 0 Then

                WithdrawalTotal += _
                    Integer.Parse(DataGridView1.Rows(counter) _
                    .Cells("Withdrawals").Value.ToString())
            End If
        End If

        If Not DataGridView1.Rows(counter) _
            .Cells("Deposits").Value Is Nothing Then

            If Not DataGridView1.Rows(counter) _
                .Cells("Deposits").Value.ToString().Length = 0 Then

                DepositTotal += _
                    Integer.Parse(DataGridView1.Rows(counter) _
                    .Cells("Deposits").Value.ToString())
            End If
        End If
    Next

    ' Iterate through the SelectedCells collection and sum up the values.
    For counter = 0 To (DataGridView1.SelectedCells.Count - 1)
        If DataGridView1.SelectedCells(counter).FormattedValueType Is _
        Type.GetType("System.String") Then

            Dim value As String = Nothing

            ' If the cell contains a value that has not been commited,
            ' use the modified value.
            If (DataGridView1.IsCurrentCellDirty = True) Then

                value = DataGridView1.SelectedCells(counter) _
                    .EditedFormattedValue.ToString()
            Else

                value = DataGridView1.SelectedCells(counter) _
                    .FormattedValue.ToString()
            End If

            If value IsNot Nothing Then

                ' Ignore cells in the Description column.
                If Not DataGridView1.SelectedCells(counter).ColumnIndex = _
                    DataGridView1.Columns("Description").Index Then

                    If Not value.Length = 0 Then
                        SelectedCellTotal += Integer.Parse(value)
                    End If
                End If
            End If
        End If

    Next

    ' Set the labels to reflect the current state of the DataGridView.
    Label1.Text = "Withdrawals Total: " & WithdrawalTotal.ToString()
    Label2.Text = "Deposits Total: " & DepositTotal.ToString()
    Label3.Text = "Selected Cells Total: " & SelectedCellTotal.ToString()
    Label4.Text = "Total entries: " & DataGridView1.RowCount.ToString()
End Sub

Remarques

Si RowCount est défini sur une valeur inférieure à la valeur actuelle, les lignes sont supprimées de la fin de la collection Rows.If RowCount is set to a value less than the current value, rows will be removed from the end of the Rows collection. Si RowCount est défini sur une valeur supérieure à la valeur actuelle, les lignes sont ajoutées à la fin de la collection Rows.If RowCount is set to a value greater than the current value, rows will be added to the end of the Rows collection. Les lignes supplémentaires sont basées sur la ligne spécifiée dans la propriété RowTemplate.The additional rows are based on the row specified in the RowTemplate property.

Si vous affectez la valeur 0 à la propriété RowCount, toutes les lignes sont supprimées de la DataGridView.If you set the RowCount property to 0, all rows will be removed from the DataGridView. Cela équivaut à appeler la méthode DataGridViewRowCollection.Clear.This is equivalent to calling the DataGridViewRowCollection.Clear method.

Notes

Si AllowUserToAddRows est true, vous ne pouvez pas affecter la valeur 0 à RowCount.If AllowUserToAddRows is true, you cannot set RowCount to 0. Dans ce cas, appelez la méthode DataGridViewRowCollection.Clear pour supprimer toutes les lignes à l’exception de la ligne pour les nouveaux enregistrements.In this case, call the DataGridViewRowCollection.Clear method to remove all rows except the row for new records. L’appel de Clear a le même résultat que l’affectation de la valeur 1 à RowCount dans ce cas, mais est beaucoup plus rapide.Calling Clear has the same result as setting RowCount to 1 in this case, but is much faster.

La propriété RowCount peut être utilisée avec la propriété ColumnCount pour créer un DataGridView simple-2 pour afficher et modifier du texte.The RowCount property can be used with the ColumnCount property to create a simple DataGridView for displaying and editing text. Si vous affectez à la propriété RowCount une valeur supérieure à 0 pour un contrôle DataGridView sans colonnes, un DataGridViewTextBoxColumn est ajouté automatiquement.If you set the RowCount property to a value greater than 0 for a DataGridView control without columns, a DataGridViewTextBoxColumn is added automatically.

S’applique à

Voir aussi