DataGridViewCell.GetEditedFormattedValue メソッド

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

DataGridViewCell.GetEditedFormattedValue メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

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

Visual Basic (宣言)

Public Function GetEditedFormattedValue ( _
    rowIndex As Integer, _
    context As DataGridViewDataErrorContexts _
) As Object

Visual Basic (使用法)

Dim instance As DataGridViewCell
Dim rowIndex As Integer
Dim context As DataGridViewDataErrorContexts
Dim returnValue As Object

returnValue = instance.GetEditedFormattedValue(rowIndex, context)

C#

public Object GetEditedFormattedValue (
    int rowIndex,
    DataGridViewDataErrorContexts context
)

C++

public:
Object^ GetEditedFormattedValue (
    int rowIndex, 
    DataGridViewDataErrorContexts context
)

J#

public Object GetEditedFormattedValue (
    int rowIndex, 
    DataGridViewDataErrorContexts context
)

JScript

public function GetEditedFormattedValue (
    rowIndex : int, 
    context : DataGridViewDataErrorContexts
) : Object

パラメータ

rowIndex

セルの行インデックス。

context

データ エラーのコンテキストを指定する DataGridViewDataErrorContexts 値のビットごとの組み合わせ。

戻り値
DataGridViewCell の現在の書式指定済みの値。

例外

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

解説

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

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

context 引数に ClipboardContent 値が含まれている場合、このメソッドをオーバーライドする派生クラスは通常、セル値の文字列形式を返します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewCell クラス
DataGridViewCell メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridView.CellFormatting イベント