DataGridViewCell.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 wartość komórki w formacie sformatowanej do wyświetlenia.
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
Wartość do sformatowania.
- 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 konwersję niestandardową na typ sformatowanej wartości lub null
jeśli taka konwersja niestandardowa nie jest wymagana.
- 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 wymagana.
- context
- DataGridViewDataErrorContexts
Bitowa kombinacja DataGridViewDataErrorContexts wartości opisujących kontekst, w którym jest wymagana sformatowana wartość.
Zwraca
Sformatowana wartość komórki lub null
jeśli komórka nie należy do kontrolki DataGridView .
Wyjątki
Formatowanie nie powiodło się i nie ma procedury obsługi dla DataError zdarzenia DataGridView kontrolki lub program obsługi ustawił ThrowException właściwość na true
. Obiekt wyjątku może być zwykle rzutowy do typu FormatException.
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 zgłasza DataGridView.CellFormatting zdarzenie. Program obsługi dla tego zdarzenia może modyfikować parametry 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.
Uwaga
Ta metoda nie konwertuje value
wartości DataGridViewCellStyle.NullValue właściwości na wartość równą DataGridViewCellStyle.DataSourceNullValue wartości właściwości, gdy DataSourceNullValue jest ustawiona na wartość inną niż DBNull.Value lub null
. W takim przypadku można obsłużyć DataGridView.CellFormatting zdarzenie, aby wyświetlić NullValue wartość właściwości. Aby uzyskać więcej informacji, zobacz przykładowy kod w pliku DataSourceNullValue.
Jeśli formatowanie nie powiedzie się, DataError wystąpi zdarzenie. Jeśli dla tego zdarzenia nie ma procedury obsługi lub program obsługi ustawia DataGridViewDataErrorEventArgs.ThrowException właściwość na true
wartość , zgłaszany jest wyjątek.
Klasy pochodne, które zastępują tę metodę, zwykle zwracają ciąg reprezentujący wartość komórki, jeśli context
argument zawiera ClipboardContent wartość.
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla