DataGridView.GetCellCount(DataGridViewElementStates) 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取满足所提供筛选器的单元格的数目。

public:
 int GetCellCount(System::Windows::Forms::DataGridViewElementStates includeFilter);

public int GetCellCount (System.Windows.Forms.DataGridViewElementStates includeFilter);

member this.GetCellCount : System.Windows.Forms.DataGridViewElementStates -> int

Public Function GetCellCount (includeFilter As DataGridViewElementStates) As Integer

参数

includeFilter

DataGridViewElementStates

DataGridViewElementStates 值的按位组合，指定要计数的单元格。

返回

Int32

与 includeFilter 参数匹配的单元格的数目。

例外

ArgumentException

includeFilter 包括 ResizableSet 值。

示例

下面的代码示例演示如何使用此方法来确定控件中 DataGridView 是否选择了任何单元格。 在此示例中，如果选择了任何单元格，则通过 GetClipboardContent 方法检索其值并在控件中 TextBox 显示。

此代码是说明使用控件剪贴板功能的大型示例的 DataGridView 一部分。 此示例是“如何：让用户从 Windows 窗体 DataGridView 控件将多个单元格复制到剪贴板”中提供的大型示例的一部分。

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.";
        }
    }
}

Private Sub CopyPasteButton_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles CopyPasteButton.Click

    If Me.DataGridView1.GetCellCount( _
        DataGridViewElementStates.Selected) > 0 Then

        Try

            ' Add the selection to the clipboard.
            Clipboard.SetDataObject( _
                Me.DataGridView1.GetClipboardContent())

            ' Replace the text box contents with the clipboard text.
            Me.TextBox1.Text = Clipboard.GetText()

        Catch ex As System.Runtime.InteropServices.ExternalException
            Me.TextBox1.Text = _
                "The Clipboard could not be accessed. Please try again."
        End Try

    End If

End Sub

注解

此方法可用于确定处于特定状态的单元格数。 若要检索所选单元格的数量，例如，请使用此方法和 DataGridViewElementStates.Selected 值。 这通常比使用 SelectedCells 属性更有效。

另请参阅

• DataGridView 控件（Windows 窗体）