DataGridViewCellStyle.NullValue 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取或设置与 DataGridView 或 null 的单元格值对应的 Value 单元格显示值。

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))>]
member this.NullValue : obj with get, set

Public Property NullValue As Object

属性值

Object

用于指示单元格为 null 值的对象。 默认值为 Empty。

属性

TypeConverterAttribute

示例

下面的代码示例演示了此属性的用法。 在此示例中， 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

注解

当具有此单元格样式的DataGridViewDBNull.Value单元格的值为 或 时null，或者用户编辑单元格并按 Ctrl+0 时，控件DataGridView将显示NullValue属性值。 当用户编辑具有此单元格样式的单元格并输入此属性的值或按 CTRL+0 时，控件会将单元格值设置为 属性的值 DataSourceNullValue 或 设置为 null （如果 DataSourceNullValue 是 DBNull.Value ，并且单元格 ValueType 是引用类型）。 以编程方式设置 属性时， DataGridViewCell.Value 不会发生此转换。

注意

当 设置为 或 以外的值时DataSourceNullValue，控件不显示NullValue与 属性值相等DataSourceNullValue的单元格值的DBNull.Valuenull属性值。 在这种情况下，可以处理 DataGridView.CellFormatting 事件以显示 NullValue 属性值。 有关详细信息，请参阅本主题中的代码示例。

此属性采用任何 对象，这使你可以使用适合单元格显示类型的类型指定值。 例如，可以将此属性设置为字符串值，供文本框单元格使用，或图像单元格使用的图像。

另请参阅

• DataGridView
• CellFormatting
• Value
• DataSourceNullValue
• IsDataSourceNullValueDefault
• 如何：在 Windows 窗体 DataGridView 控件中设置数据格式
• Windows 窗体 DataGridView 控件中的单元格样式