DataGridViewComboBoxCell.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 mise en forme des données de la cellule.
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
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
La valeur des données de la cellule après que la mise en forme a été appliquée ou null
si la cellule ne fait pas partie d'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 casté en type FormatException pour les erreurs de conversion de type ou en type ArgumentException si value
ne peut pas être trouvé dans le DataSource ou dans la collection Items.
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étermine d’abord si value
est valide en déterminant si l’une des conditions suivantes est remplie.
value
est présent dans la DataSource collection ou Items .value
estnull
ou DBNull.Value.value
est String.Empty et la valeur de la ValueType propriété représente le String type.
Si value
n’est pas valide, l’événement DataGridView.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.
Si value
est valide ou s’il existe un gestionnaire pour l’événement DataError et qu’il ne définit pas la DataGridViewDataErrorEventArgs.ThrowException propriété sur true
, l’événement DataGridView.CellFormatting se produit.
Un CellFormatting gestionnaire d’événements peut modifier à la fois value
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
. Cela peut entraîner un événement supplémentaire DataError .
Si la mise en forme réussit, cette méthode retourne la valeur mise en forme pour l’affichage dans le DataGridView contrôle.
S’applique à
Voir aussi
- FormattedValueType
- DataSource
- Items
- DataGridView
- DataGridViewCellStyle
- TypeConverter
- DataGridViewDataErrorContexts
- Format
- CellFormatting
- DataError
- GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)
- ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)