This documentation is archived and is not being maintained.

DataGridViewCellStyle.NullValue Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets the DataGridView cell display value corresponding to a cell value of DBNull.Value or a null reference (Nothing in Visual Basic).

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public Object NullValue { get; set; }
/** @property */
public Object get_NullValue ()

/** @property */
public void set_NullValue (Object value)

public function get NullValue () : Object

public function set NullValue (value : Object)

Property Value

The object used to indicate a null value in a cell. The default is String.Empty.

When a DataGridView cell with this cell style has a value of DBNull.Value or a null reference (Nothing in Visual Basic) or the user edits the cell and presses CTRL+0, the DataGridView control displays the NullValue property value. When a user edits a cell with this cell style and enters the value of this property or presses CTRL+0, the control sets the cell value to the value of the DataSourceNullValue property or to a null reference (Nothing in Visual Basic) if DataSourceNullValue is DBNull.Value and the cell ValueType is a reference type. This conversion does not occur when you set the DataGridViewCell.Value property programmatically.

NoteNote

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 a null reference (Nothing in Visual Basic). In this case, you can handle the DataGridView.CellFormatting event to display the NullValue property value.

This property takes any object, which enables you to specify a value with a type appropriate to the display type of the cell. For example, you can set this property to string values for use by text box cells or images for use by image cells.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Show: