DataGridViewComboBoxCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) メソッド

定義

セルのデータの書式指定済みの値を取得します。Gets the formatted value of the cell's data.

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

書式指定される値。The value to be formatted.

rowIndex
Int32

セルの親行のインデックス。The index of the cell's parent row.

cellStyle
DataGridViewCellStyle

セルに反映される DataGridViewCellStyleThe DataGridViewCellStyle in effect for the cell.

valueTypeConverter
TypeConverter

書式指定済みの値の型へカスタムの変換を実行する、元の値の型に関連付けられた TypeConverter。カスタムの変換が不要な場合は nullA TypeConverter associated with the value type that provides custom conversion to the formatted value type, or null if no such custom conversion is needed.

formattedValueTypeConverter
TypeConverter

書式指定済みの値の型からカスタムの変換を実行する、その値の型に関連付けられた TypeConverter。カスタムの変換が不要な場合は nullA TypeConverter associated with the formatted value type that provides custom conversion from the value type, or null if no such custom conversion is needed.

context
DataGridViewDataErrorContexts

書式指定済みの値が必要とされているコンテキストを示す DataGridViewDataErrorContexts 値のビットごとの組み合わせ。A bitwise combination of DataGridViewDataErrorContexts values describing the context in which the formatted value is needed.

戻り値

書式指定適用後のセルのデータの値。セルが DataGridView コントロールに含まれていない場合は nullThe value of the cell's data after formatting has been applied or null if the cell is not part of a DataGridView control.

例外

書式指定が失敗し、DataError コントロールの DataGridView イベントのハンドラーが定義されていないか、ハンドラーで ThrowException プロパティが true に設定されました。Formatting failed and either there is no handler for the DataError event of the DataGridView control or the handler set the ThrowException property to true. この例外オブジェクトは、通常、型変換エラーの場合は FormatException 型、valueArgumentException または DataSource コレクションに存在しない場合は Items 型にキャストできます。The exception object can typically be cast to type FormatException for type conversion errors or to type ArgumentException if value cannot be found in the DataSource or the Items collection.

注釈

コントロールDataGridViewは、このメソッドを呼び出して、セルの値を、 FormattedValueTypeプロパティで示される型の等価の表示値に変換します。The DataGridView control calls this method to convert a cell value into an equivalent display value of the type indicated by the FormattedValueType property. コントロールは、 valueパラメーターのこのメソッドにセルの値を渡します。The control passes the cell value to this method in the value parameter.

このメソッドは、次valueのいずれかの条件が満たされているかどうかを判断することによって、が有効かどうかを判断します。This method first determines whether value is valid by determining whether one of the following conditions is met.

value 有効DataGridView.DataErrorでない場合は、イベントが発生します。If value is not valid, the DataGridView.DataError event occurs. このイベントのハンドラーがない場合、またはハンドラーがDataGridViewDataErrorEventArgs.ThrowExceptionプロパティをにtrue設定した場合は、例外がスローされます。If there is no handler for this event or the handler sets the DataGridViewDataErrorEventArgs.ThrowException property to true, an exception is thrown.

value有効な場合、またはDataErrorイベントのハンドラーが存在し、 DataGridViewDataErrorEventArgs.ThrowExceptionプロパティがにtrue設定されてDataGridView.CellFormattingいない場合は、イベントが発生します。If value is valid or there is a handler for the DataError event and it does not set the DataGridViewDataErrorEventArgs.ThrowException property to true, the DataGridView.CellFormatting event occurs.

イベントCellFormattingハンドラーは、とcellStylevalue両方を変更できます。A CellFormatting event handler can modify both value and cellStyle. ただし、ハンドラーでプロパティDataGridViewCellFormattingEventArgs.FormattingAppliedがにtrue設定されていない場合、このメソッドはcellStyleオブジェクトの書式設定プロパティを使用して書式を設定します。valueIf the handler does not set the DataGridViewCellFormattingEventArgs.FormattingApplied property to true, however, this method formats value using the formatting properties of the cellStyle object. これにより、追加DataErrorのイベントが発生する可能性があります。This can result in an additional DataError event.

書式設定が成功した場合、このメソッドは、 DataGridViewコントロールに表示される書式設定された値を返します。If formatting is successful, this method returns the formatted value for display in the DataGridView control.

適用対象

こちらもご覧ください