DataGridViewCellStyle.DataSourceNullValue Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает значение, сохраняемое в источнике данных, когда пользователь вводит в ячейку значение 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)]
public object? DataSourceNullValue { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.DataSourceNullValue : obj with get, setPublic Property DataSourceNullValue As ObjectЗначение свойства
Значение, сохраняемое в источнике данных, когда пользователь задает для ячейки значение null. Значение по умолчанию — Value.
- Атрибуты
Примеры
В следующем примере кода показано использование этого свойства. В этом примере обработчик событий отображает значение свойства, 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 значения свойства. Дополнительные сведения см. в примере кода в этом разделе.
