DataGridViewComboBoxCell.GetFormattedValue Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá formátovanou hodnotu dat buňky.

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

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

Hodnota, která se má formátovat.

rowIndex

Int32

Index nadřazeného řádku buňky.

cellStyle

DataGridViewCellStyle

Hodnota DataGridViewCellStyle pro buňku.

valueTypeConverter

TypeConverter

A TypeConverter přidružené k typu hodnoty, který poskytuje vlastní převod na formátovaný typ hodnoty, nebo null pokud není takový vlastní převod potřeba.

formattedValueTypeConverter

TypeConverter

A TypeConverter přidružené k typ formátované hodnoty, který poskytuje vlastní převod z typu hodnoty, nebo null pokud není takový vlastní převod potřeba.

context

DataGridViewDataErrorContexts

Bitové kombinace DataGridViewDataErrorContexts hodnot popisujících kontext, ve kterém je formátovaná hodnota potřebná.

Návraty

Object

Hodnota dat buňky po použití formátování nebo null pokud buňka není součástí DataGridView ovládacího prvku.

Výjimky

Exception

Formátování se nezdařilo a buď neexistuje žádná obslužná rutina pro DataError událost DataGridView ovládacího prvku, nebo obslužná rutina nastavila ThrowException vlastnost na true. Objekt výjimky může být obvykle přetypován na typ FormatException pro chyby převodu typu nebo na typArgumentException, pokud value nelze najít v kolekci ItemsDataSource nebo.

Poznámky

Ovládací DataGridView prvek volá tuto metodu k převodu hodnoty buňky na ekvivalentní zobrazovanou hodnotu typu označeného FormattedValueType vlastností. Ovládací prvek předává hodnotu buňky této metodě v parametru value .

Tato metoda nejprve určí, zda value je platná, a to tak, že určí, zda je splněna jedna z následujících podmínek.

• value je přítomen v kolekci DataSourceItems nebo.

• value je null nebo DBNull.Value.

• value je String.Empty a ValueType hodnota vlastnosti představuje String typ.

Pokud value není platná, dojde k DataGridView.DataError události. Pokud pro tuto událost neexistuje žádná obslužná rutina nebo obslužná rutina DataGridViewDataErrorEventArgs.ThrowException nastaví vlastnost na true, vyvolá se výjimka.

Pokud value je platná nebo existuje obslužná rutina DataError události a nenastaví DataGridViewDataErrorEventArgs.ThrowException vlastnost na , dojde k trueDataGridView.CellFormatting události.

Obslužná rutina CellFormatting události může upravit i cellStylevalue . Pokud obslužná rutina nenastaví DataGridViewCellFormattingEventArgs.FormattingApplied vlastnost na true, ale tato metoda formátuje value pomocí vlastností formátování objektu cellStyle . Výsledkem může být další DataError událost.

Pokud je formátování úspěšné, vrátí tato metoda formátovanou hodnotu pro zobrazení v ovládacím DataGridView prvku.

Viz také

• FormattedValueType
• DataSource
• Items
• DataGridView
• DataGridViewCellStyle
• TypeConverter
• DataGridViewDataErrorContexts
• Format
• CellFormatting
• DataError
• GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
• ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)