DataGridView.GetCellCount(DataGridViewElementStates) Metoda

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera liczbę komórek, które spełniają podany filtr.

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 wartości określających DataGridViewElementStates komórki do zliczenia.

Zwraca

Int32

Liczba komórek pasujących do parametru includeFilter .

Wyjątki

ArgumentException

includeFilter zawiera wartość ResizableSet.

Przykłady

Poniższy przykład kodu ilustruje sposób użycia tej metody w celu określenia, czy w kontrolce DataGridView są zaznaczone jakiekolwiek komórki. W tym przykładzie, jeśli wybrano jakiekolwiek komórki, ich wartości są pobierane za pośrednictwem GetClipboardContent metody i wyświetlane w kontrolce TextBox .

Ten kod jest częścią większego przykładu pokazującego użycie funkcji Schowka kontrolki DataGridView . Ten przykład jest częścią większego przykładu dostępnego w temacie Instrukcje: umożliwianie użytkownikom kopiowania wielu komórek do schowka z kontrolki Windows Forms 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

Uwagi

Ta metoda jest przydatna do określenia liczby komórek w określonym stanie. Aby pobrać liczbę zaznaczonych komórek, na przykład użyj tej metody z wartością DataGridViewElementStates.Selected . Jest to zazwyczaj bardziej wydajne niż użycie SelectedCells właściwości.

Zobacz też

• DataGridView — Formant (Formularze systemu Windows)