DataGridViewComboBoxCell.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 formattato dei dati della cella.

protected:
 override 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 override 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 override 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);

override this.GetFormattedValue : obj * int * DataGridViewCellStyle * System.ComponentModel.TypeConverter * System.ComponentModel.TypeConverter * System.Windows.Forms.DataGridViewDataErrorContexts -> obj

Protected Overrides 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

Valore dei dati della cella dopo l'applicazione della formattazione oppure null se la cella non fa parte di 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. L'oggetto eccezione può in genere essere convertito nel tipo FormatException a causa di errori di conversione oppure nel tipo ArgumentException se non è possibile individuare value nell'insieme DataSource o Items.

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 determina innanzitutto se è valido determinando se value viene soddisfatta una delle condizioni seguenti.

value è presente nell'insieme DataSource Items o.
value è null o DBNull.Value.
value è String.Empty e il valore della ValueType proprietà rappresenta il String tipo.

Se value non è valido, l'evento DataGridView.DataError si verifica. Se non è presente alcun gestore per questo evento o il gestore imposta la proprietà su true, viene generata un'eccezioneDataGridViewDataErrorEventArgs.ThrowException.

Se value è valido o è presente un gestore per l'evento e non imposta la DataGridViewDataErrorEventArgs.ThrowException proprietà su true, si verifica l'evento DataError DataGridView.CellFormatting.

Un CellFormatting gestore eventi può modificare sia value che cellStyle. Se il gestore non imposta la DataGridViewCellFormattingEventArgs.FormattingApplied proprietà su true, tuttavia, questo metodo formatta value usando le proprietà di formattazione dell'oggetto cellStyle . Ciò può comportare un evento aggiuntivo DataError .

Se la formattazione ha esito positivo, questo metodo restituisce il valore formattato per la visualizzazione nel DataGridView controllo.

Si applica a