DataGridViewCellStyle.DataSourceNullValue Свойство

Определение

Получает или задает значение, сохраняемое в источнике данных, когда пользователь вводит в ячейку значение null.Gets or sets the value saved to the data source when the user enters a null value into a cell.

public:
 property System::Object ^ DataSourceNullValue { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Browsable(false)]
public object DataSourceNullValue { get; set; }
member this.DataSourceNullValue : obj with get, set
Public Property DataSourceNullValue As Object

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

Значение, сохраняемое в источнике данных, когда пользователь задает для ячейки значение null.The value saved to the data source when the user specifies a null cell value. Значение по умолчанию — Value.The default is Value.

Атрибуты

Примеры

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

Комментарии

Пользователь может ввести значение NULL в ячейку, нажав сочетание клавиш CTRL + 0 или введя значение NullValue свойства.The user can enter a null value into a cell by pressing CTRL+0 or by typing the value of the NullValue property. Когда пользователь фиксирует изменение, значение базовой ячейки устанавливается DataSourceNullValue равным значению свойства null или значение, если DataSourceNullValue равно DBNull.Value , а ячейка ValueType является ссылочным типом.When the user commits the change, the underlying cell value is set to the value of the DataSourceNullValue property or to null if DataSourceNullValue is DBNull.Value and the cell ValueType is a reference type. Это преобразование не происходит при программном задании DataGridViewCell.Value свойства.This conversion does not occur when you set the DataGridViewCell.Value property programmatically.

Примечание

Элемент управления NullValue не отображает значение свойства для значений ячейки, DataSourceNullValue равное значению свойства, если DataSourceNullValue для параметра задано значение, отличное DBNull.Value от 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. В этом случае можно выполнить обработку DataGridView.CellFormatting события, чтобы NullValue отобразить значение свойства.In this case, you can handle the DataGridView.CellFormatting event to display the NullValue property value. Дополнительные сведения см. в примере кода в этом разделе.For more information, see the code example in this topic.

Применяется к

Дополнительно