DataGridViewCell.GetFormattedValue Metoda

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá hodnotu buňky formátované pro zobrazení.

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

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

Formátovaná hodnota buňky nebo null pokud buňka nepatří do ovládacího prvku DataGridView .

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 lze obvykle přetypovat na typ FormatException.

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 vyvolá DataGridView.CellFormatting událost. Obslužná rutina pro tuto událost může upravit parametry i valuecellStyle . Pokud obslužná rutina nenastaví DataGridViewCellFormattingEventArgs.FormattingApplied vlastnost na true, ale tato metoda formátuje value pomocí vlastností formátování objektu cellStyle .

Poznámka

Tato metoda nepřevádí value hodnotu DataGridViewCellStyle.NullValue vlastnosti pro hodnoty rovnající se hodnotě DataGridViewCellStyle.DataSourceNullValue vlastnosti, pokud DataSourceNullValue je nastavena na jinou hodnotu než DBNull.Value nebo null. V tomto případě můžete zpracovat DataGridView.CellFormatting událost a zobrazit NullValue hodnotu vlastnosti. Další informace najdete v příkladu kódu v DataSourceNullValue.

Pokud formátování není úspěšné, dojde k 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.

Odvozené třídy, které přepíší tuto metodu, obvykle vrátí řetězcovou reprezentaci hodnoty buňky, pokud context argument obsahuje ClipboardContent hodnotu.

Platí pro