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