DataGridView.GetCellCount(DataGridViewElementStates) Metoda

Definicja

Pobiera liczbę komórek, które spełniają podany filtr.Gets the number of cells that satisfy the provided filter.

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

Parametry

includeFilter
DataGridViewElementStates

Bitowa kombinacja DataGridViewElementStates wartości określających komórki do zliczenia.A bitwise combination of the DataGridViewElementStates values specifying the cells to count.

Zwraca

Int32

Liczba komórek, które pasują do includeFilter parametru.The number of cells that match the includeFilter parameter.

Wyjątki

includeFilter zawiera wartość ResizableSet .includeFilter includes the value ResizableSet.

Przykłady

Poniższy przykład kodu ilustruje sposób użycia tej metody w celu ustalenia, czy w formancie są zaznaczone komórki DataGridView .The following code example illustrates how to use this method to determine whether there are any cells selected in a DataGridView control. W tym przykładzie, jeśli wybrano dowolną komórkę, ich wartości są pobierane za pomocą GetClipboardContent metody i wyświetlane w TextBox kontrolce.In this example, if any cells are selected, their values are retrieved through the GetClipboardContent method and displayed in a TextBox control.

Ten kod jest częścią większego przykładu ilustrującego użycie funkcji schowka DataGridView formantu.This code is part of a larger example illustrating the use of the Clipboard features of the DataGridView control. Ten przykład jest częścią większego przykładu dostępnego w sposób: umożliwienie użytkownikom kopiowania wielu komórek do schowka z Windows Forms formantu DataGridView.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.";
        }
    }
}
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

Uwagi

Ta metoda jest przydatna do określenia liczby komórek w konkretnym stanie.This method is useful to determine the number of cells in a particular state. Aby pobrać liczbę zaznaczonych komórek, na przykład użyj tej metody z DataGridViewElementStates.Selected wartością.To retrieve the number of selected cells, for example, use this method with the DataGridViewElementStates.Selected value. Jest to zazwyczaj bardziej wydajne niż użycie SelectedCells właściwości.This is typically more efficient than using the SelectedCells property.

Dotyczy