DataGridView.GetCellCount(DataGridViewElementStates) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient le nombre de cellules qui correspondent au filtre fourni.

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

Paramètres

includeFilter

DataGridViewElementStates

Combinaison d’opérations de bits des valeurs DataGridViewElementStates spécifiant les cellules à compter.

Retours

Int32

Nombre de cellules qui correspondent au paramètre includeFilter.

Exceptions

ArgumentException

includeFilter inclut la valeur ResizableSet.

Exemples

L’exemple de code suivant montre comment utiliser cette méthode pour déterminer s’il existe des cellules sélectionnées dans un DataGridView contrôle. Dans cet exemple, si des cellules sont sélectionnées, leurs valeurs sont récupérées par le biais de la GetClipboardContent méthode et affichées dans un TextBox contrôle.

Ce code fait partie d’un exemple plus large illustrant l’utilisation des fonctionnalités du Presse-papiers du DataGridView contrôle. Cet exemple fait partie d’un exemple plus large disponible dans How to: Enable Users to Copy Multiple Cells to the Presse-board 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

Remarques

Cette méthode est utile pour déterminer le nombre de cellules dans un état particulier. Pour récupérer le nombre de cellules sélectionnées, par exemple, utilisez cette méthode avec la DataGridViewElementStates.Selected valeur. Cela est généralement plus efficace que l’utilisation de la SelectedCells propriété.

Voir aussi

• DataGridView, contrôle (Windows Forms)