DataGridViewCellStyle.NullValue Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

public:
 property System::Object ^ NullValue { System::Object ^ get(); void set(System::Object ^ value); };

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

[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.NullValue : obj with get, set

Public Property NullValue As Object

Valeur de propriété

Object

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

Attributs

TypeConverterAttribute

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;
    }
}

' Display NullValue for cell values equal to DataSourceNullValue.
Private Sub dataGridView1_CellFormatting(ByVal sender As Object, _
    ByVal e As DataGridViewCellFormattingEventArgs) _
    Handles dataGridView1.CellFormatting

    Dim value As String = TryCast(e.Value, String)
    If value IsNot Nothing And _
        value.Equals(e.CellStyle.DataSourceNullValue) Then

        e.Value = e.CellStyle.NullValue
        e.FormattingApplied = True

    End If

End Sub

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.

Voir aussi

• DataGridView
• CellFormatting
• Value
• DataSourceNullValue
• IsDataSourceNullValueDefault
• Guide pratique pour mettre en forme des données dans le contrôle DataGridView Windows Forms
• Styles de cellules dans le contrôle DataGridView Windows Forms