DataGridView.GetCellCount(DataGridViewElementStates) Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

DataGridView.Methods.cs

Mendapatkan jumlah sel yang memenuhi filter yang disediakan.

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

Kombinasi bitwise dari nilai yang DataGridViewElementStates menentukan sel yang akan dihitung.

Mengembalikan

Int32

Jumlah sel yang cocok dengan includeFilter parameter.

Pengecualian

ArgumentException

includeFilter menyertakan nilai ResizableSet.

Contoh

Contoh kode berikut mengilustrasikan cara menggunakan metode ini untuk menentukan apakah ada sel yang dipilih dalam DataGridView kontrol. Dalam contoh ini, jika ada sel yang dipilih, nilainya diambil melalui GetClipboardContent metode dan ditampilkan dalam TextBox kontrol.

Kode ini adalah bagian dari contoh yang lebih besar yang mengilustrasikan penggunaan fitur DataGridView Clipboard kontrol. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia di Cara: Mengaktifkan Pengguna menyalin Beberapa Sel ke Clipboard dari Kontrol 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

Keterangan

Metode ini berguna untuk menentukan jumlah sel dalam keadaan tertentu. Untuk mengambil jumlah sel yang dipilih, misalnya, gunakan metode ini dengan DataGridViewElementStates.Selected nilai . Ini biasanya lebih efisien daripada menggunakan SelectedCells properti .

Lihat juga

• Kontrol DataGridView (Formulir Windows)