DataGridViewCell.ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter) メソッド

定義

表示用に書式設定された値を、実際のセル値に変換します。Converts a value formatted for display to an actual cell value.

public:
 virtual System::Object ^ ParseFormattedValue(System::Object ^ formattedValue, System::Windows::Forms::DataGridViewCellStyle ^ cellStyle, System::ComponentModel::TypeConverter ^ formattedValueTypeConverter, System::ComponentModel::TypeConverter ^ valueTypeConverter);
public virtual object ParseFormattedValue (object formattedValue, System.Windows.Forms.DataGridViewCellStyle cellStyle, System.ComponentModel.TypeConverter formattedValueTypeConverter, System.ComponentModel.TypeConverter valueTypeConverter);
abstract member ParseFormattedValue : obj * System.Windows.Forms.DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter -> obj
override this.ParseFormattedValue : obj * System.Windows.Forms.DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter -> obj
Public Overridable Function ParseFormattedValue (formattedValue As Object, cellStyle As DataGridViewCellStyle, formattedValueTypeConverter As TypeConverter, valueTypeConverter As TypeConverter) As Object

パラメーター

formattedValue
Object

セルの表示値。The display value of the cell.

cellStyle
DataGridViewCellStyle

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

formattedValueTypeConverter
TypeConverter

表示値の型の TypeConverter。既定のコンバーターを使用する場合は nullA TypeConverter for the display value type, or null to use the default converter.

valueTypeConverter
TypeConverter

セル値の型の TypeConverter。既定のコンバーターを使用する場合は nullA TypeConverter for the cell value type, or null to use the default converter.

戻り値

セル値。The cell value.

例外

cellStylenull です。cellStyle is null.

FormattedValueType プロパティ値が null である。The FormattedValueType property value is null.

- または --or- ValueType プロパティ値が null である。The ValueType property value is null.

- または --or- formattedValue を変換できません。formattedValue cannot be converted.

formattedValuenull です。formattedValue is null.

- または --or- formattedValue の型が、FormattedValueType プロパティで示される型と一致しません。The type of formattedValue does not match the type indicated by the FormattedValueType property.

注釈

ユーザーがセル値を編集して変更をコミットすると、DataGridView コントロールはこのメソッドを呼び出して、表示されている値を FormattedValueType から ValueTypeに変換します。When the user edits a cell value and commits the change, the DataGridView control calls this method to convert the displayed value from the FormattedValueType to the ValueType. 次に、コントロールは、基になるセルの値またはデータソースの値を、変換後の値に設定します。The control then sets the underlying cell value or data source value to the converted value.

このメソッドの既定の実装では、cellStyle パラメーターによって示されるセルスタイルの NullValueDataSourceNullValue、および FormatProvider プロパティを使用して、formattedValue パラメーターを解析します。The default implementation of this method parses the formattedValue parameter using the NullValue, DataSourceNullValue, and FormatProvider properties of the cell style indicated by the cellStyle parameter.

formattedValueNullValueに等しい場合、このメソッドは DataSourceNullValue プロパティの値を返します。 DataSourceNullValueDBNull.Value で、セル ValueType が参照型である場合は null を返します。If formattedValue is equal to NullValue, this method returns the value of the DataSourceNullValue property or null if DataSourceNullValue is DBNull.Value and the cell ValueType is a reference type.

formattedValueNullValueと等しくない場合、このメソッドは FormatProvider プロパティと指定されたまたは既定のコンバーターを使用して formattedValue を解析します。If formattedValue is not equal to NullValue, this method parses formattedValue using the FormatProvider property and the specified or default converters.

セル ValueType が null 許容の場合、このメソッドは戻り値を Nullable<T> 型としてラップします。If the cell ValueType is nullable, this method wraps the return value as a Nullable<T> type.

適用対象

こちらもご覧ください