DataGridViewCell.GetFormattedValue Метод

  • Ссылка

Определение

Пространство имен:
System.Windows.Forms
Сборка:
System.Windows.Forms.dll

Возвращает значение ячейки, отформатированное для отображения.

protected:
 virtual 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 virtual 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 virtual 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);
abstract member GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
override this.GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj
Protected Overridable 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.

Комментарии

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

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

Примечание

Этот метод не преобразует value в DataGridViewCellStyle.NullValue значение свойства для значений, равных значению DataGridViewCellStyle.DataSourceNullValue свойства, если DataSourceNullValue для задано значение, отличное от DBNull.Value или null. В этом случае можно обработать DataGridView.CellFormatting событие для отображения NullValue значения свойства. Дополнительные сведения см. в примере кода в разделе DataSourceNullValue.

Если форматирование не удается, DataError возникает событие . Если обработчик для этого события отсутствует или обработчик задает DataGridViewDataErrorEventArgs.ThrowException для свойства trueзначение , создается исключение.

Производные классы, которые переопределяют этот метод, обычно возвращают строковое представление значения ячейки, context если аргумент включает ClipboardContent значение .

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

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