DataGridViewComboBoxCell.GetFormattedValue メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

セルのデータの書式指定済みの値を取得します。

protected:
 override System::Object ^ GetFormattedValue(System::Object ^ value, int rowIndex, System::Windows::Forms::DataGridViewCellStyle ^ % cellStyle, System::ComponentModel::TypeConverter ^ valueTypeConverter, System::ComponentModel::TypeConverter ^ formattedValueTypeConverter, System::Windows::Forms::DataGridViewDataErrorContexts context);

protected override object GetFormattedValue (object value, int rowIndex, ref System.Windows.Forms.DataGridViewCellStyle cellStyle, System.ComponentModel.TypeConverter valueTypeConverter, System.ComponentModel.TypeConverter formattedValueTypeConverter, System.Windows.Forms.DataGridViewDataErrorContexts context);

override this.GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj

Protected Overrides Function GetFormattedValue (value As Object, rowIndex As Integer, ByRef cellStyle As DataGridViewCellStyle, valueTypeConverter As TypeConverter, formattedValueTypeConverter As TypeConverter, context As DataGridViewDataErrorContexts) As Object

パラメーター

value

Object

書式指定される値。

rowIndex

Int32

セルの親行のインデックス。

cellStyle

DataGridViewCellStyle

セルに反映される DataGridViewCellStyle

valueTypeConverter

TypeConverter

書式指定済みの値の型へカスタムの変換を実行する、元の値の型に関連付けられた TypeConverter。カスタムの変換が不要な場合は null。

formattedValueTypeConverter

TypeConverter

書式指定済みの値の型からカスタムの変換を実行する、その値の型に関連付けられた TypeConverter。カスタムの変換が不要な場合は null。

context

DataGridViewDataErrorContexts

書式指定済みの値が必要とされているコンテキストを示す DataGridViewDataErrorContexts 値のビットごとの組み合わせ。

戻り値

Object

書式指定適用後のセルのデータの値。セルが DataGridView コントロールに含まれていない場合は null。

例外

Exception

書式指定が失敗し、DataError コントロールの DataGridView イベントのハンドラーが定義されていないか、ハンドラーで ThrowException プロパティが true に設定されました。 この例外オブジェクトは、通常、型変換エラーの場合は FormatException 型、value が ArgumentException または DataSource コレクションに存在しない場合は Items 型にキャストできます。

注釈

コントロールは DataGridView 、このメソッドを呼び出して、セル値を プロパティによって示される型の同等の表示値に FormattedValueType 変換します。 コントロールは、 パラメーター内のこのメソッドにセル値を value 渡します。

このメソッドは、次のいずれかの条件が満たされているかどうかを判断することによって、最初に が有効かどうかを判断 value します。

• value が または コレクションに DataSource 存在します Items 。

• value は null または DBNull.Value です。

• value は String.Empty で、プロパティ値 ValueType は 型を String 表します。

が無効な場合 value 、イベントが DataGridView.DataError 発生します。 このイベントのハンドラーがない場合、またはハンドラーによって プロパティが DataGridViewDataErrorEventArgs.ThrowException に true設定されている場合は、例外がスローされます。

が有効であるか、イベントのハンドラーがあり、 DataError プロパティが にtrue設定DataGridViewDataErrorEventArgs.ThrowExceptionされていない場合value、イベントがDataGridView.CellFormatting発生します。

イベント ハンドラーでは CellFormatting 、 と の両方 value を cellStyle変更できます。 ただし、ハンドラーで プロパティが DataGridViewCellFormattingEventArgs.FormattingApplied に true設定されていない場合、このメソッド value は オブジェクトの書式設定プロパティを使用して書式を cellStyle 設定します。 これにより、追加 DataError のイベントが発生する可能性があります。

書式設定が成功した場合、このメソッドはコントロールに表示する書式設定された値を DataGridView 返します。

こちらもご覧ください

• FormattedValueType
• DataSource
• Items
• DataGridView
• DataGridViewCellStyle
• TypeConverter
• DataGridViewDataErrorContexts
• Format
• CellFormatting
• DataError
• GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
• ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)