DataGridViewCellStyle.DataSourceNullValue Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit la valeur enregistrée dans la source de données lorsque l'utilisateur entre une valeur null dans une cellule.

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

[System.ComponentModel.Browsable(false)]
public object DataSourceNullValue { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.DataSourceNullValue : obj with get, set

Public Property DataSourceNullValue As Object

Valeur de propriété

Object

Valeur enregistrée dans la source de données lorsque l'utilisateur spécifie une valeur de cellule null. La valeur par défaut est Value.

Attributs

BrowsableAttribute

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 propriété lorsque la NullValue 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

L’utilisateur peut entrer une valeur null dans une cellule en appuyant sur Ctrl+0 ou en tapant la valeur de la NullValue propriété. Lorsque l’utilisateur valide la modification, la valeur de la cellule sous-jacente est définie sur la valeur de la DataSourceNullValue propriété ou sur null si DataSourceNullValue est DBNull.Value et si la cellule ValueType est un type de 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.

Voir aussi

• DataGridView
• CellFormatting
• Value
• IsDataSourceNullValueDefault
• NullValue
• Styles de cellules dans le contrôle DataGridView Windows Forms