DataGridViewCell.EditedFormattedValue Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Hücrenin düzenleme modunda olup olmamasına ve değerin kaydedilmemiş olmasına bakılmaksızın hücrenin geçerli, biçimlendirilmiş değerini alır.

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

Özellik Değeri

Object

öğesinin geçerli, biçimlendirilmiş değeri DataGridViewCell.

Öznitelikler

BrowsableAttribute

Özel durumlar

ArgumentOutOfRangeException

Hücreyi içeren satır paylaşılan bir satırdır.

-veya-

Hücre bir sütun başlığı hücresidir.

InvalidOperationException

ColumnIndex 0'dan küçükse, hücrenin bir satır üst bilgi hücresi olduğunu gösterir.

Exception

Biçimlendirme başarısız oldu ve denetimin DataError olayı DataGridView için işleyici yok veya işleyici özelliğini olarak trueayarladıThrowException. Özel durum nesnesi genellikle türüne FormatExceptionyayınlanabilir.

Örnekler

Aşağıdaki kod örneği özelliğinin nasıl kullanılacağını EditedFormattedValue gösterir. Bu örnekte özelliği, IsCurrentCellDirty geçerli hücrenin içeriğinin düzenlenip düzenlenmediğini ve işlenmediğini belirlemek için kullanılır ve hücre değiştirildiyse, düzenlenen değer kullanılır. Bu örnek, olayda DataGridView.SelectionChanged kullanılabilen daha büyük bir örneğin bir parçasıdır.

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

Açıklamalar

Bu özellik, hücre düzenleme modundaysa hücrenin veya düzenleme denetiminin geçerli değerini döndürür. Aksi takdirde, bu özelliğin değerini almak, hücre değerini özelliği tarafından FormattedValueType belirtilen türdeki eşdeğer bir görüntüleme değerine dönüştürür. Bu, değer dönüştürmeyi DataGridView.CellFormatting özelleştirmek için işleyebileceğiniz olayı tetikler.

Biçimlendirme başarısız olursa, DataGridView.DataError olay gerçekleşir. Bu olay için işleyici yoksa veya işleyici özelliğini olarak trueayarlarsaDataGridViewDataErrorEventArgs.ThrowException, bir özel durum oluşturulur.

Ayrıca bkz.

• DataGridView