DataGridViewCell.GetFormattedValue Méthode

Définition

Obtient la valeur de la cellule telle qu'elle est mise en forme pour l'affichage.

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

Paramètres

value
Object

Valeur à mettre en forme.

rowIndex
Int32

Index de la ligne parente de la cellule.

cellStyle
DataGridViewCellStyle

DataGridViewCellStyle en vigueur pour la cellule.

valueTypeConverter
TypeConverter

TypeConverter associé au type valeur qui fournit la conversion personnalisée en type valeur mise en forme, ou null si une telle conversion personnalisée n'est pas nécessaire.

formattedValueTypeConverter
TypeConverter

TypeConverter associé au type valeur mise en forme qui fournit la conversion personnalisée du type valeur, ou null si une telle conversion personnalisée n'est pas nécessaire.

context
DataGridViewDataErrorContexts

Combinaison d'opérations de bits des valeurs DataGridViewDataErrorContexts indiquant le contexte dans lequel la valeur mise en forme est nécessaire.

Retours

Valeur mise en forme de la cellule ou null si la cellule n'appartient pas à un contrôle DataGridView.

Exceptions

La mise en forme a échoué et soit il n'y a aucun gestionnaire pour l'événement DataError du contrôle DataGridView, soit le gestionnaire a affecté true à la propriété ThrowException. L’objet exception peut généralement être converti en type FormatException.

Remarques

Le DataGridView contrôle appelle cette méthode pour convertir une valeur de cellule en une valeur d’affichage équivalente du type indiqué par la FormattedValueType propriété. Le contrôle transmet la valeur de cellule à cette méthode dans le value paramètre .

Cette méthode déclenche l’événement DataGridView.CellFormatting . Un gestionnaire pour cet événement peut modifier les value paramètres et cellStyle . Si le gestionnaire ne définit pas la DataGridViewCellFormattingEventArgs.FormattingApplied propriété sur true, toutefois, cette méthode met en forme value à l’aide des propriétés de mise en forme de l’objet cellStyle .

Notes

Cette méthode ne convertit pas en value valeur de propriété pour les DataGridViewCellStyle.NullValue valeurs égales à la valeur de propriété DataGridViewCellStyle.DataSourceNullValue lorsque DataSourceNullValue est défini sur une valeur autre que DBNull.Value ou null. Dans ce cas, vous pouvez gérer l’événement DataGridView.CellFormatting pour afficher la valeur de la NullValue propriété. Pour plus d’informations, consultez l’exemple de code dans DataSourceNullValue.

Si la mise en forme échoue, l’événement DataError se produit. S’il n’existe aucun gestionnaire pour cet événement ou si le gestionnaire définit la DataGridViewDataErrorEventArgs.ThrowException propriété sur true, une exception est levée.

Les classes dérivées qui remplacent cette méthode retournent généralement une représentation sous forme de chaîne de la valeur de cellule si l’argument context inclut la ClipboardContent valeur.

S’applique à

Voir aussi