DataGridViewCellStyle.NullValue Свойство

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))]
public object? NullValue { get; set; }

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

Public Property NullValue As Object

Объект, используемый для указания значения null в ячейке. Значение по умолчанию — Empty.

Атрибуты

TypeConverterAttribute

В следующем примере кода показано использование этого свойства. В этом примере обработчик событий отображает значение свойства, DataGridView.CellFormattingNullValue если значение ячейки 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

Если ячейка DataGridView с таким стилем имеет значение DBNull.Value или null или пользователь изменяет ячейку и нажимает клавиши CTRL+0, DataGridView элемент управления отображает NullValue значение свойства . Когда пользователь изменяет ячейку с этим стилем и вводит значение этого свойства или нажимает клавиши CTRL+0, элемент управления присваивает значению ячейки значение DataSourceNullValue свойства или значение , null если DataSourceNullValue имеет значение DBNull.Value и ячейка ValueType является ссылочным типом. Это преобразование не происходит при установке DataGridViewCell.Value свойства программным способом.

Это свойство принимает любой объект , который позволяет указать значение с типом, соответствующим типу отображения ячейки. Например, для этого свойства можно задать строковые значения для использования в ячейках текстового поля или изображениях для ячеек изображений.

• DataGridView
• CellFormatting
• Value
• DataSourceNullValue
• IsDataSourceNullValueDefault
• Практическое руководство. Форматирование данных элемента управления DataGridView в Windows Forms
• Стили ячеек элемента управления DataGridView в Windows Forms