DataGridViewCheckBoxCell.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.

Комментарии

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

Этот метод сначала пытается преобразовать value в значение или CheckState с помощью TrueValueсвойств , и IndeterminateValue , FalseValueесли они Boolean были заданы.

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

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

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

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

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

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