DataGridView.RowCount プロパティ

.NET Framework クラス ライブラリ リファレンス

DataGridView.RowCount プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

DataGridView に表示する行数を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property RowCount As
 Integer

Visual Basic (使用法)

Dim instance As DataGridView
Dim value As Integer

value = instance.RowCount

instance.RowCount = value

C#

public int RowCount { get;
 set; }

C++

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

J#

/** @property */
public int get_RowCount ()

/** @property */
public void set_RowCount (int
 value)

JScript

public function get RowCount
 () : int

public function set RowCount
 (value : int)

プロパティ値
DataGridView に表示する行数。

例外

例外の種類	条件
ArgumentException	このプロパティの設定時に指定された値が 0 未満です。 または 指定された値が 1 未満で、AllowUserToAddRows が true に設定されています。
InvalidOperationException	このプロパティを設定したときに、DataSource プロパティが設定されています。

解説

RowCount が現在の値より小さい値に設定された場合、Rows コレクションの末尾から行が削除されます。RowCount が現在の値よりも大きい値に設定された場合、Rows コレクションの末尾に行が追加されます。追加される行は、RowTemplate プロパティで指定された行に基づいています。

RowCount プロパティを 0 に設定すると、DataGridView からすべての行が削除されます。これは、DataGridViewRowCollection.Clear メソッドを呼び出すのと同じです。

メモ
AllowUserToAddRows が true の場合、RowCount は 0 に設定できません。この場合、新規レコード行を除くすべての行を削除するには、DataGridViewRowCollection.Clear メソッドを呼び出します。Clear を呼び出すのも、RowCount を 1 に設定するのも結果は同じですが、前者の方が時間がかかりません。

RowCount プロパティと ColumnCount プロパティを使用して、テキストを表示および編集するための単純な DataGridView を作成できます。列がない DataGridView コントロールに対して RowCount プロパティを 0 より大きい値に設定すると、DataGridViewTextBoxColumn が自動的に追加されます。

使用例

RowCount プロパティの使用方法を示すコード例を次に示します。この例では、このプロパティを使用して DataGridView 内のエントリ数が追跡されます。

Visual Basic

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 Not value Is
 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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
その他の技術情報
DataGridView コントロール (Windows フォーム)