乐胖代购免代理版

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataGridViewCell.EditedFormattedValue プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

セルが編集モードであるかどうか、および値がコミットされているかどうかに関係なく、セルの現在の書式指定済みの値を取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 EditedFormattedValue As Object

Visual Basic (使用法)

Dim instance As DataGridViewCell
Dim value As Object

value = instance.EditedFormattedValue

public Object EditedFormattedValue { get; }

C++

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

/** @property */
public Object get_EditedFormattedValue ()

JScript

public function get EditedFormattedValue
 () : Object

プロパティ値
DataGridViewCell の現在の書式指定済みの値。

例外

例外の種類	条件
ArgumentOutOfRangeException	セルを含む行が共有行です。またはセルが列ヘッダーのセルです。
InvalidOperationException	ColumnIndex が 0 未満です。これは、セルが行ヘッダーのセルであることを示します。
Exception	書式指定が失敗し、DataGridView コントロールの DataError イベントのハンドラが定義されていないか、ハンドラで ThrowException プロパティが true に設定されました。例外オブジェクトは通常、FormatException 型にキャストできます。

例外の種類

条件

ArgumentOutOfRangeException

セルを含む行が共有行です。

または

セルが列ヘッダーのセルです。

InvalidOperationException

ColumnIndex が 0 未満です。これは、セルが行ヘッダーのセルであることを示します。

Exception

書式指定が失敗し、DataGridView コントロールの DataError イベントのハンドラが定義されていないか、ハンドラで ThrowException プロパティが true に設定されました。例外オブジェクトは通常、FormatException 型にキャストできます。

解説

このプロパティは、セルの現在の値、またはセルが編集モードである場合は編集コントロールの現在の値を返します。それ以外の場合、このプロパティの値を取得すると、FormattedValueType プロパティで示される型の等価な表示用の値にセル値が変換されます。これによって DataGridView.CellFormatting イベントが発生します。このイベントを処理して、値の変換をカスタマイズできます。

書式指定に失敗すると、DataGridView.DataError イベントが発生します。このイベントのハンドラがない場合や、ハンドラで DataGridViewDataErrorEventArgs.ThrowException プロパティを true に設定している場合、例外がスローされます。

使用例

EditedFormattedValue プロパティを使用する方法を次のコード例に示します。この例では、IsCurrentCellDirty プロパティを使用して、現在のセルの内容が編集されているかどうか、および未コミットかどうかを確認し、セルが変更されていた場合は、編集された値が使用されます。

Visual Basic

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 Not value Is
 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

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();
}