DataGridViewCell.EditedFormattedValue Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá aktuální formátovanou hodnotu buňky bez ohledu na to, zda je buňka v režimu úprav a hodnota nebyla potvrzena.

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

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

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

Public ReadOnly Property EditedFormattedValue As Object

Hodnota vlastnosti

Object

Aktuální formátovaná hodnota parametru DataGridViewCell.

Atributy

BrowsableAttribute

Výjimky

ArgumentOutOfRangeException

Řádek obsahující buňku je sdílený řádek.

-nebo-

Buňka je buňka záhlaví sloupce.

InvalidOperationException

ColumnIndex je menší než 0, což znamená, že buňka je buňka záhlaví řádku.

Exception

Formátování se nezdařilo a buď neexistuje žádná obslužná rutina pro DataError událost DataGridView ovládacího prvku, nebo obslužná rutina nastavila ThrowException vlastnost na true. Objekt výjimky lze obvykle přetypovat na typ FormatException.

Příklady

Následující příklad kódu ukazuje, jak použít EditedFormattedValue vlastnost. V tomto příkladu IsCurrentCellDirty se vlastnost používá k určení, jestli byl obsah aktuální buňky upraven a není potvrzen, a pokud byla buňka změněna, použije se upravená hodnota. Tento příklad je součástí většího příkladu, který je k dispozici v DataGridView.SelectionChanged události.

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

Poznámky

Tato vlastnost vrátí aktuální hodnotu buňky nebo ovládacího prvku pro úpravy, pokud je buňka v režimu úprav. Jinak získání hodnoty této vlastnosti převede hodnotu buňky na ekvivalentní zobrazovanou hodnotu typu označeného FormattedValueType vlastností. Tím se vyvolá DataGridView.CellFormatting událost, kterou můžete zpracovat a přizpůsobit převod hodnoty.

Pokud formátování není úspěšné, dojde k DataGridView.DataError události. Pokud pro tuto událost neexistuje žádná obslužná rutina nebo obslužná rutina DataGridViewDataErrorEventArgs.ThrowException nastaví vlastnost na true, vyvolá se výjimka.

Viz také

• DataGridView