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);
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

Значение данный ячейки после применения форматирования или null, если ячейка не является частью элемента управления DataGridView.

Исключения

Exception

Форматирование закончилось неудачей, и либо отсутствует обработчик для события DataError элемента управления DataGridView, либо обработчик установил для свойства ThrowException значение true. Объект исключения обычно может быть приведен к типу FormatException для ошибок преобразования типа или к типу ArgumentException, если value не удается найти в коллекции DataSource или Items.

Комментарии

Элемент DataGridView управления вызывает этот метод для преобразования значения ячейки в эквивалентное отображаемое значение типа, указанного свойством FormattedValueType . Элемент управления передает значение ячейки этому методу в параметре value .

Этот метод сначала определяет, является ли value допустимым, определяя, выполняется ли одно из следующих условий.

  • value присутствует в DataSource коллекции или Items .

  • value имеет значение null или DBNull.Value.

  • value имеет значение , String.Empty а ValueType значение свойства представляет String тип .

Если value значение не является допустимым DataGridView.DataError , происходит событие . Если обработчик для этого события отсутствует или обработчик задает свойству DataGridViewDataErrorEventArgs.ThrowExceptiontrueзначение , создается исключение.

Если value является допустимым или имеется обработчик для DataError события, а свойству DataGridViewDataErrorEventArgs.ThrowExceptiontrueне присваивается значение , DataGridView.CellFormatting событие возникает.

CellFormatting Обработчик событий может изменять как , так value и cellStyle. Однако если обработчик не задает свойству DataGridViewCellFormattingEventArgs.FormattingAppliedtrueзначение , этот метод форматирует value с помощью свойств cellStyle форматирования объекта . Это может привести к дополнительному DataError событию.

Если форматирование выполнено успешно, этот метод возвращает форматируемое значение для отображения в элементе DataGridView управления .

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

См. также раздел