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.Gets or sets the DataGridView cell display value corresponding to a cell value of Value or 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; }
member this.NullValue : obj with get, set
Public Property NullValue As Object

Valeur de propriété

Objet utilisé pour indiquer une valeur null dans une cellule.The object used to indicate a null value in a cell. La valeur par défaut est Empty,The default is Empty.

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

Quand une DataGridView cellule avec ce style de cellule a une valeur de DBNull.Value ou null ou si l’utilisateur modifie la cellule et appuie sur CTRL + 0, le contrôle DataGridView affiche la valeur de la propriété NullValue.When a DataGridView cell with this cell style has a value of DBNull.Value or null or the user edits the cell and presses CTRL+0, the DataGridView control displays the NullValue property value. 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 propriété DataSourceNullValue ou sur null si DataSourceNullValue est DBNull.Value et que la cellule ValueType est un type référence.When a user edits a cell with this cell style and enters the value of this property or presses CTRL+0, the control sets the cell value 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.

Cette propriété accepte n’importe quel objet, ce qui vous permet de spécifier une valeur avec un type approprié pour le type d’affichage de la cellule.This property takes any object, which enables you to specify a value with a type appropriate to the display type of the cell. Par exemple, vous pouvez définir cette propriété sur des valeurs de chaîne à utiliser par des cellules de zone de texte ou des images pour une utilisation par des cellules d’image.For example, you can set this property to string values for use by text box cells or images for use by image cells.

S’applique à

Voir aussi