DataGridViewCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) DataGridViewCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) DataGridViewCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) DataGridViewCell.GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts) Method

Определение

Получает значение ячейки, отформатированное для отображения.Gets the value of the cell as formatted for display.

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);
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 Object Object Object

Форматируемое значение.The value to be formatted.

rowIndex
Int32 Int32 Int32 Int32

Индекс родительской строки ячейки.The index of the cell's parent row.

cellStyle
DataGridViewCellStyle DataGridViewCellStyle DataGridViewCellStyle DataGridViewCellStyle

Стиль DataGridViewCellStyle, установленный для ячейки.The DataGridViewCellStyle in effect for the cell.

valueTypeConverter
TypeConverter TypeConverter TypeConverter TypeConverter

Объект TypeConverter, связанный с типом значения, который предоставляет настраиваемое преобразование в тип форматированного значения, либо значение null, если настраиваемое преобразование не требуется.A TypeConverter associated with the value type that provides custom conversion to the formatted value type, or null if no such custom conversion is needed.

formattedValueTypeConverter
TypeConverter TypeConverter TypeConverter TypeConverter

Объект TypeConverter, связанный с типом форматированного значения, который предоставляет настраиваемое преобразование из типа значения, либо значение null, если такое настраиваемое преобразование не требуется.A TypeConverter associated with the formatted value type that provides custom conversion from the value type, or null if no such custom conversion is needed.

context
DataGridViewDataErrorContexts DataGridViewDataErrorContexts DataGridViewDataErrorContexts DataGridViewDataErrorContexts

Побитовая комбинация значений DataGridViewDataErrorContexts, описывающая контекст, в котором требуется форматированное значение.A bitwise combination of DataGridViewDataErrorContexts values describing the context in which the formatted value is needed.

Возвраты

Отформатированное значение ячейки или значение null, если ячейка не принадлежит элементу управления DataGridView.The formatted value of the cell or null if the cell does not belong to a DataGridView control.

Исключения

Форматирование закончилось неудачей, и либо отсутствует обработчик для события DataError элемента управления DataGridView, либо обработчик установил для свойства ThrowException значение true.Formatting failed and either there is no handler for the DataError event of the DataGridView control or the handler set the ThrowException property to true. Объект исключения обычно можно привести к типу FormatException.The exception object can typically be cast to type FormatException.

Комментарии

Элемент управления вызывает этот метод для преобразования значения ячейки в эквивалентное отображаемое значение типа, указанного FormattedValueType свойством. DataGridViewThe DataGridView control calls this method to convert a cell value into an equivalent display value of the type indicated by the FormattedValueType property. Элемент управления передает значение ячейки этому методу в value параметре.The control passes the cell value to this method in the value parameter.

Этот метод вызывает DataGridView.CellFormatting событие.This method raises the DataGridView.CellFormatting event. Обработчик для этого события может изменять оба value параметра и. cellStyleA handler for this event can modify both the value and cellStyle parameters. Однако если DataGridViewCellFormattingEventArgs.FormattingApplied обработчик не устанавливает свойство в trueзначение, то этот метод форматируется value с помощью свойств cellStyle форматирования объекта.If the handler does not set the DataGridViewCellFormattingEventArgs.FormattingApplied property to true, however, this method formats value using the formatting properties of the cellStyle object.

Примечание

Этот метод value не преобразует DataGridViewCellStyle.NullValue в значение свойства DataGridViewCellStyle.DataSourceNullValue для значений, равных значению свойства, если DataSourceNullValue для задано значение, отличное от DBNull.Value или null.This method does not convert value to the DataGridViewCellStyle.NullValue property value for values equal to the DataGridViewCellStyle.DataSourceNullValue property value when DataSourceNullValue is set to a value other than DBNull.Value or null. В этом случае можно выполнить обработку DataGridView.CellFormatting события, чтобы NullValue отобразить значение свойства.In this case, you can handle the DataGridView.CellFormatting event to display the NullValue property value. Дополнительные сведения см. в примере кода в разделе DataSourceNullValue.For more information, see the code example in DataSourceNullValue.

Если форматирование завершается неудачно, DataError возникает событие.If formatting is unsuccessful, the DataError event occurs. Если обработчик для этого события отсутствует или обработчик задает DataGridViewDataErrorEventArgs.ThrowException для trueсвойства значение, создается исключение.If there is no handler for this event or the handler sets the DataGridViewDataErrorEventArgs.ThrowException property to true, an exception is thrown.

Производные классы, переопределяющие этот метод, обычно возвращают строковое представление значения ячейки context , если аргумент ClipboardContent включает значение.Derived classes that override this method will typically return a string representation of the cell value if the context argument includes the ClipboardContent value.

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

Дополнительно