DataGridViewCellStyle.DataSourceNullValue Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Получает или задает значение, сохраняемое в источнике данных, когда пользователь вводит в ячейку значение 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

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

Атрибуты

BrowsableAttribute

Примеры

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

Комментарии

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

Примечание

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

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

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