DataGridViewCell.GetFormattedValue Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene il valore della cella formattato per la visualizzazione.
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
Parametri
- value
- Object
Valore da formattare.
- rowIndex
- Int32
Indice della riga padre della cella.
- cellStyle
- DataGridViewCellStyle
DataGridViewCellStyle attivo per la cella.
- valueTypeConverter
- TypeConverter
Classe TypeConverter associata al tipo di valore che fornisce la conversione personalizzata nel tipo di valore formattato oppure null
se non è necessaria alcuna conversione personalizzata.
- formattedValueTypeConverter
- TypeConverter
Classe TypeConverter associata al tipo di valore formattato che fornisce la conversione personalizzata dal tipo di valore oppure null
se non è necessaria alcuna conversione personalizzata.
- context
- DataGridViewDataErrorContexts
Combinazione bit per bit dei valori di DataGridViewDataErrorContexts che descrive il contesto in cui è necessario il valore formattato.
Restituisce
Il valore formattato della cella o null
se la cella non appartiene a un controllo DataGridView.
Eccezioni
La formattazione non è riuscita e non esiste alcun gestore per l'evento DataError del controllo DataGridView oppure il gestore ha impostato la proprietà ThrowException su true
. In genere è possibile eseguire il cast dell'oggetto eccezione al tipo FormatException.
Commenti
Il DataGridView controllo chiama questo metodo per convertire un valore di cella in un valore di visualizzazione equivalente del tipo indicato dalla FormattedValueType proprietà . Il controllo passa il valore della cella a questo metodo nel value
parametro .
Questo metodo genera l'evento DataGridView.CellFormatting . Un gestore per questo evento può modificare i value
parametri e cellStyle
. Se il gestore non imposta la DataGridViewCellFormattingEventArgs.FormattingApplied proprietà su true
, tuttavia, questo metodo formatta value
utilizzando le proprietà di formattazione dell'oggetto cellStyle
.
Nota
Questo metodo non esegue la conversione value
nel valore della DataGridViewCellStyle.NullValue proprietà per i valori uguali al valore della DataGridViewCellStyle.DataSourceNullValue proprietà quando DataSourceNullValue è impostato su un valore diverso da DBNull.Value o null
. In questo caso, è possibile gestire l'evento DataGridView.CellFormatting per visualizzare il valore della NullValue proprietà. Per altre informazioni, vedere l'esempio di codice in DataSourceNullValue.
Se la formattazione ha esito negativo, l'evento DataError si verifica. Se non è presente alcun gestore per questo evento o il gestore imposta la DataGridViewDataErrorEventArgs.ThrowException proprietà su true
, viene generata un'eccezione.
Le classi derivate che eseguono l'override di questo metodo restituiranno in genere una rappresentazione di stringa del valore della cella se l'argomento context
include il ClipboardContent valore .
Si applica a
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per