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

Стиль DataGridViewCellStyle, установленный для ячейки.The DataGridViewCellStyle in effect for the cell.

formattedValueTypeConverter
TypeConverter

Объект TypeConverter для типа отображаемого значения или значение null для использования конвертера по умолчанию.A TypeConverter for the display value type, or null to use the default converter.

valueTypeConverter
TypeConverter

Объект TypeConverter для типа значения ячейки, или значение null для использования конвертера по умолчанию.A TypeConverter for the cell value type, or null to use the default converter.

Возвраты

Значение ячейки.The cell value.

Исключения

Свойство cellStyle имеет значение null.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.

Реализация этого метода по умолчанию анализирует параметр formattedValue с помощью свойств NullValue, DataSourceNullValueи FormatProvider стиля ячейки, указанного параметром cellStyle.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.

Если formattedValue равен NullValue, этот метод возвращает значение свойства DataSourceNullValue или null, если DataSourceNullValue имеет DBNull.Value и ячейка ValueType является ссылочным типом.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.

Если formattedValue не равно NullValue, этот метод выполняет синтаксический анализ formattedValue с помощью свойства FormatProvider и указанного конвертера или преобразователей по умолчанию.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.

Применяется к

Дополнительно