DataGridView.GetCellCount(DataGridViewElementStates) 메서드

정의

제공된 필터를 충족하는 셀의 수를 가져옵니다.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

매개 변수

includeFilter
DataGridViewElementStates

수를 계산할 셀을 지정하는 DataGridViewElementStates 값의 비트 조합입니다.A bitwise combination of the DataGridViewElementStates values specifying the cells to count.

반환

includeFilter 매개 변수와 일치하는 셀의 수입니다.The number of cells that match the includeFilter parameter.

예외

includeFilter가 값 ResizableSet을 포함하는 경우includeFilter includes the value ResizableSet.

예제

다음 코드 예제에서 선택한 모든 셀이 있는지 여부를 확인 하려면이 메서드를 사용 하는 방법을 보여 줍니다는 DataGridView 제어 합니다.The following code example illustrates how to use this method to determine whether there are any cells selected in a DataGridView control. 이 예제에서는 모든 셀을 선택 하는 경우 해당 값을 검색을 통해 합니다 GetClipboardContent 메서드 표시는 TextBox 제어 합니다.In this example, if any cells are selected, their values are retrieved through the GetClipboardContent method and displayed in a TextBox control.

이 코드는 클립보드 기능의 사용을 보여주는 보다 큰 예제의 일부는 DataGridView 제어 합니다.This code is part of a larger example illustrating the use of the Clipboard features of the DataGridView control. 이 예제는 에서 사용할 수 있는 더 큰 예제의 일부입니다. 사용자가 Windows Forms 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

설명

이 메서드는 특정 상태에 있는 셀의 수를 결정 하는 데 유용 합니다.This method is useful to determine the number of cells in a particular state. 선택된 된 셀의 수를 검색 하려면 예를 들어이 메서드를 사용 합니다 DataGridViewElementStates.Selected 값입니다.To retrieve the number of selected cells, for example, use this method with the DataGridViewElementStates.Selected value. 이 일반적으로 사용 하 여 보다 효율적인는 SelectedCells 속성입니다.This is typically more efficient than using the SelectedCells property.

적용 대상

추가 정보