DataGridView.GetCellCount(DataGridViewElementStates) Méthode

Définition

Obtient le nombre des cellules qui correspondent au filtre fourni.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

Paramètres

includeFilter
DataGridViewElementStates

Combinaison d'opérations de bits de valeurs DataGridViewElementStates spécifiant les cellules à compter.A bitwise combination of the DataGridViewElementStates values specifying the cells to count.

Retours

Nombre de cellules qui correspondent au paramètre includeFilter.The number of cells that match the includeFilter parameter.

Exceptions

includeFilter inclut la valeur ResizableSet.includeFilter includes the value ResizableSet.

Exemples

L’exemple de code suivant montre comment utiliser cette méthode pour déterminer si des cellules sont sélectionnées dans un contrôle DataGridView.The following code example illustrates how to use this method to determine whether there are any cells selected in a DataGridView control. Dans cet exemple, si des cellules sont sélectionnées, leurs valeurs sont récupérées via la méthode GetClipboardContent et affichées dans un contrôle TextBox.In this example, if any cells are selected, their values are retrieved through the GetClipboardContent method and displayed in a TextBox control.

Ce code fait partie d’un exemple plus complet illustrant l’utilisation des fonctionnalités du presse-papiers du contrôle DataGridView.This code is part of a larger example illustrating the use of the Clipboard features of the DataGridView control. Cet exemple fait partie d’un exemple plus complet disponible dans How à : Permettre aux utilisateurs de copier plusieurs cellules dans le presse-papiers à partir du contrôle DataGridView Windows Forms.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

Remarques

Cette méthode est utile pour déterminer le nombre de cellules dans un état particulier.This method is useful to determine the number of cells in a particular state. Pour récupérer le nombre de cellules sélectionnées, par exemple, utilisez cette méthode avec la valeur DataGridViewElementStates.Selected.To retrieve the number of selected cells, for example, use this method with the DataGridViewElementStates.Selected value. Cela est généralement plus efficace que l’utilisation de la propriété SelectedCells.This is typically more efficient than using the SelectedCells property.

S’applique à

Voir aussi