DataGridViewCellStyle.DataSourceNullValue Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridViewCellStyle.cs

Возвращает или задает значение, сохраненное в источнике данных, когда пользователь вводит значение NULL в ячейку.

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

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

Object

Значение, сохраненное в источнике данных, когда пользователь задает значение пустой ячейки. Значение по умолчанию — Value.

Атрибуты

BrowsableAttribute

Примеры

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

Комментарии

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

Замечание

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

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

• DataGridView
• CellFormatting
• Value
• IsDataSourceNullValueDefault
• NullValue
• Стили ячеек в элементе управления DataGridView в Windows Forms