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 값의 비트 조합입니다.

반환

형식이 지정된 셀 값이거나, 셀이 DataGridView 컨트롤에 속하지 않으면 null입니다.

예외

형식 지정이 실패하고 DataError 컨트롤의 DataGridView 이벤트에 대한 처리기가 없거나 처리기에서 ThrowException 속성을 true로 설정한 경우. 예외 개체는 일반적으로 FormatException 형식으로 캐스팅할 수 있습니다.

설명

합니다 DataGridView 셀 값으로 지정 된 형식의 해당 하는 표시 값으로 변환 하려면이 메서드를 호출 하는 컨트롤을 FormattedValueType 속성입니다. 컨트롤에서이 메서드는 셀 값을 전달 합니다 value 매개 변수입니다.

이 메서드는 DataGridView.CellFormatting 이벤트입니다. 이 이벤트에 대한 처리기는 및 cellStyle 매개 변수를 모두 수정할 value 수 있습니다. 그러나 처리기를 설정 하지 않는 경우는 DataGridViewCellFormattingEventArgs.FormattingApplied 속성을 true,이 메서드 형식 value 의 서식 속성을 사용 하 여는 cellStyle 개체입니다.

참고

이 메서드는 가 또는 이외의 값으로 DataGridViewCellStyle.NullValue 설정된 경우 DataSourceNullValue 속성 값과 동일한 값의 DataGridViewCellStyle.DataSourceNullValue 속성 값으로 변환 value 되지 DBNull.Value 않습니다.null 이 경우 이벤트를 처리 DataGridView.CellFormatting 하여 속성 값을 표시할 NullValue 수 있습니다. 자세한 내용은 의 코드 예제를 참조하세요 DataSourceNullValue.

정상적이 지 않습니다 서식 지정 하는 경우는 DataError 이벤트가 발생 합니다. 이 이벤트 또는 처리기 집합에 대 한 처리기가 하는 경우는 DataGridViewDataErrorEventArgs.ThrowException 속성을 true, 예외가 throw 됩니다.

이 메서드를 재정의하는 파생 클래스는 일반적으로 인수에 값이 포함된 경우 셀 값의 문자열 표현을 contextClipboardContent 반환합니다.

적용 대상

추가 정보