DataGridViewComboBoxCell.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.
Исключения
Форматирование закончилось неудачей, и либо отсутствует обработчик для события 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 управления .
Применяется к
См. также раздел
- FormattedValueType
- DataSource
- Items
- DataGridView
- DataGridViewCellStyle
- TypeConverter
- DataGridViewDataErrorContexts
- Format
- CellFormatting
- DataError
- GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
- ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по