DataGridView.GetCellCount(DataGridViewElementStates) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die Anzahl der Zellen ab, die dem bereitgestellten Filter entsprechen.

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

Parameter

includeFilter

DataGridViewElementStates

Eine bitweise Kombination der DataGridViewElementStates-Werte, die die zu zählenden Zellen angibt.

Gibt zurück

Int32

Die Anzahl der Zellen, die mit dem includeFilter-Parameter übereinstimmen.

Ausnahmen

ArgumentException

includeFilter enthält den Wert ResizableSet.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie diese Methode verwenden, um festzustellen, ob in einem DataGridView Steuerelement zellen ausgewählt sind. In diesem Beispiel werden ihre Werte durch die GetClipboardContent Methode abgerufen und in einem TextBox Steuerelement angezeigt.

Dieser Code ist Teil eines größeren Beispiels, das die Verwendung der Zwischenablagefeatures des DataGridView Steuerelements veranschaulicht. In diesem Beispiel ist ein größeres Beispiel verfügbar in How to: Enable Users to Copy Multiple Cells to the Zwischenablage aus dem Windows Forms DataGridView-Steuerelement.

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

Hinweise

Diese Methode ist nützlich, um die Anzahl der Zellen in einem bestimmten Zustand zu bestimmen. Um die Anzahl der ausgewählten Zellen abzurufen, verwenden Sie beispielsweise diese Methode mit dem DataGridViewElementStates.Selected Wert. Dies ist in der Regel effizienter als die Verwendung der SelectedCells Eigenschaft.

Siehe auch

• DataGridView-Steuerelement (Windows Forms)