DataGridViewCell.GetFormattedValue Metoda
Definice
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
Formátovaná hodnota buňky nebo null
pokud buňka nepatří do ovládacího prvku DataGridView .
Výjimky
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 value
cellStyle
. 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
Viz také
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro