DataGridViewCell.GetFormattedValue Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient la valeur de la cellule comme 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 -> objProtected Overridable Function GetFormattedValue (value As Object, rowIndex As Integer, ByRef cellStyle As DataGridViewCellStyle, valueTypeConverter As TypeConverter, formattedValueTypeConverter As TypeConverter, context As DataGridViewDataErrorContexts) As ObjectParamètres
- value
- Object
Valeur à mettre en forme.
- rowIndex
- Int32
Index de la ligne parente de la cellule.
- cellStyle
- DataGridViewCellStyle
Effet DataGridViewCellStyle de la cellule.
- valueTypeConverter
- TypeConverter
Associé TypeConverter au type valeur qui fournit une conversion personnalisée vers le type valeur mis en forme, ou null si aucune conversion personnalisée n’est nécessaire.
- formattedValueTypeConverter
- TypeConverter
Associé TypeConverter au type valeur mis en forme qui fournit une conversion personnalisée à partir du type valeur, ou null si aucune conversion personnalisée n’est nécessaire.
- context
- DataGridViewDataErrorContexts
Combinaison de valeurs au niveau du DataGridViewDataErrorContexts bit décrivant 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 DataGridView contrôle.
Exceptions
La mise en forme a échoué et il n’existe aucun gestionnaire pour l’événement DataError du DataGridView contrôle ou le gestionnaire a défini la ThrowException propriété truesur . L’objet d’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 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 paramètres et value les cellStyle paramètres. Si le gestionnaire ne définit pas la DataGridViewCellFormattingEventArgs.FormattingApplied propriété truesur , toutefois, cette méthode se met en forme value à l’aide des propriétés de mise en forme de l’objet cellStyle .
Note
Cette méthode ne se convertit value pas en DataGridViewCellStyle.NullValue valeur de propriété pour les valeurs égales à la DataGridViewCellStyle.DataSourceNullValue valeur de propriété lorsqu’elle DataSourceNullValue est définie 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é truesur , 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.
