DataGridViewCell.FormattedValue Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mendapatkan nilai sel seperti yang diformat untuk ditampilkan.

public:
 property System::Object ^ FormattedValue { System::Object ^ get(); };

[System.ComponentModel.Browsable(false)]
public object FormattedValue { get; }

[<System.ComponentModel.Browsable(false)>]
member this.FormattedValue : obj

Public ReadOnly Property FormattedValue As Object

Nilai Properti

Object

Nilai sel yang diformat atau null jika sel bukan milik DataGridView kontrol.

Atribut

BrowsableAttribute

Pengecualian

InvalidOperationException

ColumnIndex kurang dari 0, menunjukkan bahwa sel tersebut adalah sel header baris.

ArgumentOutOfRangeException

Baris yang berisi sel adalah baris bersama.

-atau-

Sel adalah sel header kolom.

Exception

Pemformatan gagal dan tidak ada handler untuk DataError peristiwa DataGridView kontrol atau handler mengatur ThrowException properti ke true. Objek pengecualian biasanya dapat dilemparkan ke jenis FormatException.

Contoh

Contoh kode berikut menunjukkan cara menggunakan FormattedValue properti . Dalam contoh ini, IsCurrentCellDirty properti digunakan untuk menentukan apakah konten sel saat ini telah diedit dan tidak diterapkan dan, jika sel telah dimodifikasi, FormattedValue akan digunakan. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia dalam peristiwa tersebut DataGridView.SelectionChanged .

private void UpdateLabelText()
{
    int WithdrawalTotal = 0;
    int DepositTotal = 0;
    int SelectedCellTotal = 0;
    int counter;

    // Iterate through all the rows and sum up the appropriate columns.
    for (counter = 0; counter < (DataGridView1.Rows.Count);
        counter++)
    {
        if (DataGridView1.Rows[counter].Cells["Withdrawals"].Value
            != null)
        {
            if (DataGridView1.Rows[counter].
                Cells["Withdrawals"].Value.ToString().Length != 0)
            {
                WithdrawalTotal += int.Parse(DataGridView1.Rows[counter].
                    Cells["Withdrawals"].Value.ToString());
            }
        }

        if (DataGridView1.Rows[counter].Cells["Deposits"].Value != null)
        {
            if (DataGridView1.Rows[counter]
                .Cells["Deposits"].Value.ToString().Length != 0)
            {
                DepositTotal += int.Parse(DataGridView1.Rows[counter]
                    .Cells["Deposits"].Value.ToString());
            }
        }
    }

    // Iterate through the SelectedCells collection and sum up the values.
    for (counter = 0;
        counter < (DataGridView1.SelectedCells.Count); counter++)
    {
        if (DataGridView1.SelectedCells[counter].FormattedValueType ==
            Type.GetType("System.String"))
        {
            string value = null;

            // If the cell contains a value that has not been commited,
            // use the modified value.
            if (DataGridView1.IsCurrentCellDirty == true)
            {

                value = DataGridView1.SelectedCells[counter]
                    .EditedFormattedValue.ToString();
            }
            else
            {
                value = DataGridView1.SelectedCells[counter]
                    .FormattedValue.ToString();
            }
            if (value != null)
            {
                // Ignore cells in the Description column.
                if (DataGridView1.SelectedCells[counter].ColumnIndex !=
                    DataGridView1.Columns["Description"].Index)
                {
                    if (value.Length != 0)
                    {
                        SelectedCellTotal += int.Parse(value);
                    }
                }
            }
        }
    }

    // Set the labels to reflect the current state of the DataGridView.
    Label1.Text = "Withdrawals Total: " + WithdrawalTotal.ToString();
    Label2.Text = "Deposits Total: " + DepositTotal.ToString();
    Label3.Text = "Selected Cells Total: " + SelectedCellTotal.ToString();
    Label4.Text = "Total entries: " + DataGridView1.RowCount.ToString();
}

Private Sub UpdateLabelText()
    Dim WithdrawalTotal As Integer = 0
    Dim DepositTotal As Integer = 0
    Dim SelectedCellTotal As Integer = 0
    Dim counter As Integer

    ' Iterate through all the rows and sum up the appropriate columns.
    For counter = 0 To (DataGridView1.Rows.Count - 1)
        If Not DataGridView1.Rows(counter) _
            .Cells("Withdrawals").Value Is Nothing Then

            If Not DataGridView1.Rows(counter) _
                .Cells("Withdrawals").Value.ToString().Length = 0 Then

                WithdrawalTotal += _
                    Integer.Parse(DataGridView1.Rows(counter) _
                    .Cells("Withdrawals").Value.ToString())
            End If
        End If

        If Not DataGridView1.Rows(counter) _
            .Cells("Deposits").Value Is Nothing Then

            If Not DataGridView1.Rows(counter) _
                .Cells("Deposits").Value.ToString().Length = 0 Then

                DepositTotal += _
                    Integer.Parse(DataGridView1.Rows(counter) _
                    .Cells("Deposits").Value.ToString())
            End If
        End If
    Next

    ' Iterate through the SelectedCells collection and sum up the values.
    For counter = 0 To (DataGridView1.SelectedCells.Count - 1)
        If DataGridView1.SelectedCells(counter).FormattedValueType Is _
        Type.GetType("System.String") Then

            Dim value As String = Nothing

            ' If the cell contains a value that has not been commited,
            ' use the modified value.
            If (DataGridView1.IsCurrentCellDirty = True) Then

                value = DataGridView1.SelectedCells(counter) _
                    .EditedFormattedValue.ToString()
            Else

                value = DataGridView1.SelectedCells(counter) _
                    .FormattedValue.ToString()
            End If

            If value IsNot Nothing Then

                ' Ignore cells in the Description column.
                If Not DataGridView1.SelectedCells(counter).ColumnIndex = _
                    DataGridView1.Columns("Description").Index Then

                    If Not value.Length = 0 Then
                        SelectedCellTotal += Integer.Parse(value)
                    End If
                End If
            End If
        End If

    Next

    ' Set the labels to reflect the current state of the DataGridView.
    Label1.Text = "Withdrawals Total: " & WithdrawalTotal.ToString()
    Label2.Text = "Deposits Total: " & DepositTotal.ToString()
    Label3.Text = "Selected Cells Total: " & SelectedCellTotal.ToString()
    Label4.Text = "Total entries: " & DataGridView1.RowCount.ToString()
End Sub

Keterangan

Properti Value adalah objek data aktual yang dimuat oleh sel, sedangkan FormattedValue adalah representasi yang diformat dari objek ini. Properti ValueType dan FormattedValueType masing-masing sesuai dengan jenis data nilai-nilai ini.

Mendapatkan nilai properti ini memanggil GetFormattedValue metode untuk mengonversi nilai sel menjadi nilai tampilan yang setara dari jenis yang ditunjukkan FormattedValueType oleh properti . Ini meningkatkan DataGridView.CellFormatting peristiwa, yang dapat Anda tangani untuk menyesuaikan konversi nilai.

Jika pemformatan tidak berhasil, peristiwa akan DataGridView.DataError terjadi. Jika tidak ada handler untuk kejadian ini atau handler mengatur DataGridViewDataErrorEventArgs.ThrowException properti ke true, pengecualian akan dilemparkan.

Lihat juga

• DataGridView
• FormattedValueType
• Value
• ValueType
• IDataGridViewEditingControl