DataGridViewCellStyle.NullValue Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает отображаемое значение ячейки DataGridView, соответствующее значению ячейки Value или значение 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

Значение свойства

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 свойства программным способом.

Примечание

Элемент управления не отображает NullValue значение свойства для значений ячеек, равных значению DataSourceNullValue свойства, если DataSourceNullValue задано значение, отличное от DBNull.Value или null. В этом случае можно обработать DataGridView.CellFormatting событие для отображения NullValue значения свойства. Дополнительные сведения см. в примере кода в этом разделе.

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

См. также раздел

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