DataGridViewCellStyle.DataSourceNullValue Propriété

Définition

Obtient ou définit la valeur enregistrée dans la source de données lorsque l'utilisateur entre une valeur null dans une cellule.Gets or sets the value saved to the data source when the user enters a null value into a cell.

public:
 property System::Object ^ DataSourceNullValue { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Browsable(false)]
public object DataSourceNullValue { get; set; }
member this.DataSourceNullValue : obj with get, set
Public Property DataSourceNullValue As Object

Valeur de propriété

Valeur enregistrée dans la source de données lorsque l'utilisateur spécifie une valeur de cellule null.The value saved to the data source when the user specifies a null cell value. La valeur par défaut est Value,The default is Value.

Attributs

Exemples

L’exemple de code suivant illustre l’utilisation de cette propriété.The following code example illustrates the use of this property. Dans cet exemple, un gestionnaire d’événements DataGridView.CellFormatting affiche la valeur de la propriété NullValue lorsque la valeur de cellule est égale à DataSourceNullValue.In this example, a DataGridView.CellFormatting event handler displays the value of the NullValue property when the cell value equals 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 propriété NullValue.The user can enter a null value into a cell by pressing CTRL+0 or by typing the value of the NullValue property. Lorsque l’utilisateur valide la modification, la valeur de la cellule sous-jacente est définie sur la valeur de la propriété DataSourceNullValue ou sur null si DataSourceNullValue est DBNull.Value et que la cellule ValueType est un type référence.When the user commits the change, the underlying cell value is set to the value of the DataSourceNullValue property or to null if DataSourceNullValue is DBNull.Value and the cell ValueType is a reference type. Cette conversion ne se produit pas lorsque vous définissez la propriété DataGridViewCell.Value par programmation.This conversion does not occur when you set the DataGridViewCell.Value property programmatically.

Notes

Le contrôle n’affiche pas la valeur de la propriété NullValue pour les valeurs de cellule égales à la valeur de propriété DataSourceNullValue lorsque DataSourceNullValue est définie sur une valeur autre que DBNull.Value ou null.The control does not display the NullValue property value for cell values equal to the DataSourceNullValue property value when DataSourceNullValue is set to a value other than DBNull.Value or null. Dans ce cas, vous pouvez gérer l’événement DataGridView.CellFormatting pour afficher la valeur de la propriété NullValue.In this case, you can handle the DataGridView.CellFormatting event to display the NullValue property value. Pour plus d’informations, consultez l’exemple de code dans cette rubrique.For more information, see the code example in this topic.

S’applique à

Voir aussi