DataGridView.RowCount Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví počet řádků zobrazených v objektu DataGridView.

public:
 property int RowCount { int get(); void set(int value); };

[System.ComponentModel.Browsable(false)]
public int RowCount { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.RowCount : int with get, set

Public Property RowCount As Integer

Hodnota vlastnosti

Int32

Počet řádků, které se mají zobrazit v objektu DataGridView.

Atributy

BrowsableAttribute

Výjimky

ArgumentException

Zadaná hodnota při nastavení této vlastnosti je menší než 0.

-nebo-

Zadaná hodnota je menší než 1 a AllowUserToAddRows je nastavená na truehodnotu .

InvalidOperationException

Při nastavování této vlastnosti je nastavena DataSource vlastnost.

Příklady

Následující příklad kódu ukazuje použití RowCount vlastnosti. V tomto příkladu se tato vlastnost používá ke sledování počtu položek v objektu DataGridView. Tento příklad je součástí většího příkladu, který je k dispozici v SelectionChanged události.

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

Poznámky

Pokud RowCount je nastavená hodnota menší než aktuální hodnota, odeberou se řádky z konce Rows kolekce. Pokud RowCount je nastavená hodnota větší než aktuální hodnota, budou řádky přidány Rows na konec kolekce. Další řádky jsou založené na řádku zadaném RowTemplate ve vlastnosti.

Pokud nastavíte RowCount vlastnost na hodnotu 0, odeberou se z objektu všechny řádky DataGridView. To je ekvivalent volání DataGridViewRowCollection.Clear metody.

Poznámka

Pokud AllowUserToAddRows je true, nemůžete nastavit RowCount hodnotu 0. V tomto případě voláním DataGridViewRowCollection.Clear metody odeberte všechny řádky s výjimkou řádku pro nové záznamy. Volání Clear má v tomto případě stejný výsledek jako nastavení RowCount na hodnotu 1, ale je mnohem rychlejší.

Vlastnost RowCount lze s vlastností použít ColumnCount k vytvoření jednoduchého DataGridView zobrazení a úpravy textu. Pokud nastavíte RowCount vlastnost na hodnotu větší než 0 DataGridView ovládacího prvku bez sloupců, DataGridViewTextBoxColumn přidá se automaticky.

Viz také

• DataGridView – ovládací prvek (Windows Forms)