Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

DataGridView.RowCount-Eigenschaft

Ruft die Anzahl der Zeilen ab, die im DataGridView-Steuerelement angezeigt werden, oder legt diese Anzahl fest.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
[BrowsableAttribute(false)]
public int RowCount { get; set; }

Eigenschaftswert

Typ: System.Int32
Die Anzahl der Zeilen, die im DataGridView-Steuerelement angezeigt werden.
Ausnahme Bedingung
ArgumentException

Der beim Festlegen dieser Eigenschaft angegebene Wert ist kleiner als 0.

– oder –

Der angegebene Wert ist kleiner als 1, und AllowUserToAddRows wird auf true festgelegt.

InvalidOperationException

Wenn Sie diese Eigenschaft festlegen, wird die DataSource-Eigenschaft festgelegt.

Wenn RowCount auf einen Wert festgelegt wird, der unter dem aktuellen Wert liegt, werden Zeilen am Ende der Rows-Auflistung entfernt. Wenn RowCount auf einen Wert festgelegt wird, der über dem aktuellen Wert liegt, werden Zeilen am Ende der Rows-Auflistung hinzugefügt. Die zusätzlichen Zeilen basieren auf der in der RowTemplate-Eigenschaft angegebenen Zeile.

Wenn die RowCount-Eigenschaft auf 0 (null) festgelegt ist, werden alle Zeilen aus DataGridView entfernt. Dies entspricht dem Aufruf der DataGridViewRowCollection.Clear-Methode.

Hinweis Hinweis

Wenn AllowUserToAddRowstrue ist, können Sie RowCount nicht auf 0 festlegen. Rufen Sie in diesem Fall die DataGridViewRowCollection.Clear-Methode auf, um alle Zeilen außer der Zeile für neue Datensätze zu entfernen. Der Aufruf von Clear führt zum gleichen Ergebnis wie - in diesem Fall - RowCount auf 1 festzulegen, ist jedoch wesentlich schneller.

Die RowCount-Eigenschaft kann mit der ColumnCount-Eigenschaft verwendet werden, um eine einfache DataGridView zum Anzeigen und Bearbeiten von Text zu erstellen. Wenn Sie die RowCount-Eigenschaft auf einen Wert größer (null) für ein DataGridView-Steuerelement ohne Spalten festlegen, wird automatisch DataGridViewTextBoxColumn hinzugefügt.

Im folgenden Codebeispiel wird die Verwendung der RowCount-Eigenschaft veranschaulicht. In diesem Beispiel wird mit dieser Eigenschaft die Anzahl der Einträge in einer DataGridView nachverfolgt. Dieses Beispiel ist Teil eines umfangreicheren Beispiels, das im SelectionChanged-Ereignis verfügbar ist.


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();
}


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?