DataGridViewComboBoxCell.GetFormattedValue Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera sformatowaną wartość danych komórki.
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
Parametry
- value
- Object
Wartość, która ma być sformatowana.
- rowIndex
- Int32
Indeks wiersza nadrzędnego komórki.
- cellStyle
- DataGridViewCellStyle
Efekt DataGridViewCellStyle dla komórki.
- valueTypeConverter
- TypeConverter
Skojarzony TypeConverter z typem wartości, który zapewnia niestandardową konwersję do sformatowanego typu wartości lub null
jeśli taka konwersja niestandardowa nie jest potrzebna.
- formattedValueTypeConverter
- TypeConverter
Skojarzony TypeConverter z sformatowanym typem wartości, który zapewnia konwersję niestandardową z typu wartości lub null
jeśli taka konwersja niestandardowa nie jest potrzebna.
- context
- DataGridViewDataErrorContexts
Bitowa kombinacja DataGridViewDataErrorContexts wartości opisujących kontekst, w którym jest wymagana sformatowana wartość.
Zwraca
Wartość danych komórki po zastosowaniu formatowania lub null
jeśli komórka nie jest częścią kontrolki DataGridView .
Wyjątki
Formatowanie nie powiodło się i nie ma procedury obsługi zdarzenia DataErrorDataGridView kontrolki lub program obsługi ustawił ThrowException właściwość na true
. Obiekt wyjątku może być zwykle rzutowy do typu FormatException dla błędów konwersji typu lub do wpisywania ArgumentException , jeśli value
nie można odnaleźć w DataSource kolekcji lub Items .
Uwagi
Kontrolka DataGridView wywołuje tę metodę, aby przekonwertować wartość komórki na równoważną wartość wyświetlaną typu wskazanego FormattedValueType przez właściwość. Kontrolka przekazuje wartość komórki do tej metody w parametrze value
.
Ta metoda najpierw określa, czy value
jest prawidłowa, określając, czy jest spełniony jeden z następujących warunków.
value
znajduje się w kolekcji DataSourceItems lub .value
jest lubnull
DBNull.Value.value
jest String.Empty i ValueType wartość właściwości reprezentuje String typ.
Jeśli value
zdarzenie jest nieprawidłowe, DataGridView.DataError występuje zdarzenie. Jeśli dla tego zdarzenia nie ma programu obsługi lub program obsługi ustawia DataGridViewDataErrorEventArgs.ThrowException właściwość na true
wartość , zgłaszany jest wyjątek.
Jeśli value
jest prawidłowa lub istnieje procedura obsługi dla DataError zdarzenia i nie ustawia DataGridViewDataErrorEventArgs.ThrowException właściwości na true
, DataGridView.CellFormatting występuje zdarzenie.
Program CellFormatting obsługi zdarzeń może modyfikować zarówno , jak value
i cellStyle
. Jeśli program obsługi nie ustawi DataGridViewCellFormattingEventArgs.FormattingApplied właściwości na true
, jednak ta metoda formatuje value
przy użyciu właściwości cellStyle
formatowania obiektu. Może to spowodować dodatkowe DataError zdarzenie.
Jeśli formatowanie zakończy się pomyślnie, ta metoda zwraca sformatowaną wartość do wyświetlenia w kontrolce DataGridView .
Dotyczy
Zobacz też
- FormattedValueType
- DataSource
- Items
- DataGridView
- DataGridViewCellStyle
- TypeConverter
- DataGridViewDataErrorContexts
- Format
- CellFormatting
- DataError
- GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
- ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)