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.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
Комментарии
Если ячейка DataGridView с этим стилем ячейки имеет значение DBNull.Value или null пользователь редактирует ячейку и нажимает КЛАВИШИ CTRL+0, элемент DataGridView управления отображает NullValue значение свойства. Когда пользователь редактирует ячейку с этим стилем ячейки и вводит значение этого свойства или нажимает клавиши CTRL+0, элемент управления задает значение ячейки значением DataSourceNullValue свойства или DataSourceNullValuenull значением , если это DBNull.Value и ячейка ValueType является ссылочным типом. Это преобразование не происходит при программном DataGridViewCell.Value установке свойства.
Замечание
Элемент управления не отображает NullValue значение свойства для значений ячеек, равных DataSourceNullValue значению свойства, если DataSourceNullValue задано значение, отличное DBNull.Value от или null. В этом случае можно обрабатывать DataGridView.CellFormatting событие для отображения NullValue значения свойства. Дополнительные сведения см. в примере кода в этом разделе.
Это свойство принимает любой объект, который позволяет указать значение с типом, соответствующим типу отображаемой ячейки. Например, это свойство можно задать для строковых значений, используемых ячейками текстового поля или изображениями для использования ячейками изображений.
