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 буфера обмена элемента управления. Этот пример является частью более крупного примера, доступного в разделе "Практическое руководство. Разрешить пользователям копировать несколько ячеек в буфер обмена" из элемента управления DataGridView Windows Forms.

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 Forms)