DataGridViewCell.GetFormattedValue Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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

Object

Il valore formattato della cella o null se la cella non appartiene a un controllo DataGridView.

Eccezioni

Exception

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