DataGridViewCellStyle.DataSourceNullValue 属性

  • 参考

定义

命名空间:
System.Windows.Forms
程序集:
System.Windows.Forms.dll

获取或设置用户在单元格中输入 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, set
Public Property DataSourceNullValue As Object

属性值

Object

当用户输入 null 单元格值时保存到数据源的值。 默认值为 Value。

属性
BrowsableAttribute

示例

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

注解

用户可以通过按 Ctrl+0 或键入 属性的值 NullValue ，在单元格中输入 null 值。 当用户提交更改时，基础单元格值将设置为 属性的值DataSourceNullValue，如果 DataSourceNullValue 为 DBNull.Value ，则设置为 null ，并且单元格ValueType是引用类型。 以编程方式设置 属性时， DataGridViewCell.Value 不会发生此转换。

注意

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

适用于

另请参阅