Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

DataGridViewCell.GetFormattedValue méthode (Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)

 

Date de publication : novembre 2016

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

Espace de noms:   System.Windows.Forms
Assembly:  System.Windows.Forms (dans System.Windows.Forms.dll)

protected virtual object GetFormattedValue(
	object value,
	int rowIndex,
	ref DataGridViewCellStyle cellStyle,
	TypeConverter valueTypeConverter,
	TypeConverter formattedValueTypeConverter,
	DataGridViewDataErrorContexts context
)

Paramètres

value
Type: System.Object

La valeur à mettre en forme.

rowIndex
Type: System.Int32

Index de la ligne parente de la cellule.

cellStyle
Type: System.Windows.Forms.DataGridViewCellStyle

Le DataGridViewCellStyle en vigueur pour la cellule.

valueTypeConverter
Type: System.ComponentModel.TypeConverter

Un TypeConverter associé au type valeur qui fournit la conversion personnalisée pour le type valeur mise en forme, ou null si telle conversion personnalisée n’est nécessaire.

formattedValueTypeConverter
Type: System.ComponentModel.TypeConverter

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

context
Type: System.Windows.Forms.DataGridViewDataErrorContexts

Combinaison de bits de DataGridViewDataErrorContexts valeurs décrivant le contexte dans lequel la valeur mise en forme est nécessaire.

Valeur de retour

Type: System.Object

La valeur mise en forme de la cellule ou null Si la cellule n’appartient pas à un DataGridView contrôle.

Exception Condition
Exception

Échec de la mise en forme et il n’existe aucun gestionnaire pour le DataError événements du DataGridView contrôle ou le gestionnaire défini le ThrowException propriété true. L’objet exception peut généralement être converti en type FormatException.

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

Cette méthode déclenche la DataGridView.CellFormatting événement. Un gestionnaire pour cet événement peut modifier les value et cellStyle paramètres. Si le gestionnaire n’affecte pas le DataGridViewCellFormattingEventArgs.FormattingApplied propriété true, cependant, cette méthode met value en utilisant les propriétés de mise en forme du cellStyle objet.

System_CAPS_noteRemarque

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

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

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

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: