Export (0) Print
Expand All
Expand Minimize

DataGridView.GetCellCount Method

Gets the number of cells that satisfy the provided filter.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public int GetCellCount(
	DataGridViewElementStates includeFilter
)

Parameters

includeFilter
Type: System.Windows.Forms.DataGridViewElementStates

A bitwise combination of the DataGridViewElementStates values specifying the cells to count.

Return Value

Type: System.Int32
The number of cells that match the includeFilter parameter.

ExceptionCondition
ArgumentException

includeFilter includes the value ResizableSet.

This method is useful to determine the number of cells in a particular state. To retrieve the number of selected cells, for example, use this method with the DataGridViewElementStates.Selected value. This is typically more efficient than using the SelectedCells property.

The following code example illustrates how to use this method to determine whether there are any cells selected in a DataGridView control. In this example, if any cells are selected, their values are retrieved through the GetClipboardContent method and displayed in a TextBox control.

This code is part of a larger example illustrating the use of the Clipboard features of the DataGridView control. This example is part of a larger example available in How to: Enable Users to Copy Multiple Cells to the Clipboard from the Windows Forms DataGridView Control.

private void CopyPasteButton_Click(object sender, System.EventArgs e)
{
    if (this.DataGridView1
        .GetCellCount(DataGridViewElementStates.Selected) > 0)
    {
        try
        {
            // Add the selection to the clipboard.
            Clipboard.SetDataObject(
                this.DataGridView1.GetClipboardContent());

            // Replace the text box contents with the clipboard text. 
            this.TextBox1.Text = Clipboard.GetText();
        }
        catch (System.Runtime.InteropServices.ExternalException)
        {
            this.TextBox1.Text = 
                "The Clipboard could not be accessed. Please try again.";
        }
    }
}

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

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0

Community Additions

ADD
Show:
© 2015 Microsoft