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