DataGridViewCellStyle.NullValue Propriété

Définition

Obtient ou définit la valeur d'affichage de la cellule DataGridView correspondant à une valeur de cellule égale à Value ou null.

[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public object NullValue { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public object? NullValue { get; set; }

Valeur de propriété

Objet utilisé pour indiquer une valeur null dans une cellule. La valeur par défaut est Empty.

Attributs

Exemples

L’exemple de code suivant illustre l’utilisation de cette propriété. Dans cet exemple, un gestionnaire d’événements DataGridView.CellFormatting affiche la valeur de la NullValue propriété lorsque la valeur de la cellule est égale à DataSourceNullValue.

// Display NullValue for cell values equal to DataSourceNullValue.
private void dataGridView1_CellFormatting(object sender,
    DataGridViewCellFormattingEventArgs e)
{
    String value = e.Value as string;
    if ((value != null) && value.Equals(e.CellStyle.DataSourceNullValue))
    {
        e.Value = e.CellStyle.NullValue;
        e.FormattingApplied = true;
    }
}

Remarques

Lorsqu’une DataGridView cellule avec ce style de DBNull.Value cellule a la valeur ou null que l’utilisateur modifie la cellule et appuie sur Ctrl+0, le DataGridView contrôle affiche la valeur de la NullValue propriété. Lorsqu’un utilisateur modifie une cellule avec ce style de cellule et entre la valeur de cette propriété ou appuie sur Ctrl+0, le contrôle définit la valeur de la cellule sur la valeur de la DataSourceNullValue propriété ou sur null si DataSourceNullValue est DBNull.Value et la cellule ValueType est un type référence. Cette conversion ne se produit pas lorsque vous définissez la DataGridViewCell.Value propriété par programmation.

Notes

Le contrôle n’affiche pas la valeur de propriété pour les NullValue valeurs de cellule égales à la valeur de propriété 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 de cette rubrique.

Cette propriété accepte n’importe quel objet, ce qui vous permet de spécifier une valeur avec un type approprié au type d’affichage de la cellule. Par exemple, vous pouvez définir cette propriété sur des valeurs de chaîne à utiliser par les cellules de zone de texte ou les images à utiliser par les cellules d’image.

S’applique à

Produit Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Voir aussi