DataGridViewCheckBoxCell.GetFormattedValue Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает форматированное значение данных ячейки.
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, описывающая контекст, в котором требуется форматированное значение.
Возвращаемое значение
Значение данный ячейки после применения форматирования или 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 управления .
Применяется к
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по