DataGridViewCellStyle.NullValue 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

取得或設定 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))>]
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

備註

DataGridView當具有此儲存格樣式的儲存格具有 或 的值 DBNull.Value ， null 或使用者編輯儲存格並按 CTRL+0 時， DataGridView 控制項會顯示 NullValue 屬性值。 當使用者編輯具有此儲存格樣式的儲存格，並輸入此屬性的值或按下 CTRL+0 時，控制項會將儲存格值設定為 屬性的值 DataSourceNullValue ，如果 nullDataSourceNullValue 為 DBNull.Value ，而且儲存格 ValueType 是參考類型。 當您以程式設計方式設定 DataGridViewCell.Value 屬性時，不會進行這項轉換。

注意

當 設定為 或 null 以外的 DBNull.Value 值時 DataSourceNullValue ， NullValue 控制項不會顯示等於 DataSourceNullValue 屬性值之儲存格值的屬性值。 在此情況下，您可以處理 DataGridView.CellFormatting 事件以顯示 NullValue 屬性值。 如需詳細資訊，請參閱本主題中的程式碼範例。

這個屬性會接受任何 物件，這可讓您指定具有適合儲存格顯示類型之類型的值。 例如，您可以將此屬性設定為字串值，以供文字方塊儲存格使用，或影像儲存格使用影像。

另請參閱

• DataGridView
• CellFormatting
• Value
• DataSourceNullValue
• IsDataSourceNullValueDefault
• 操作說明：格式化 Windows Forms DataGridView 控制項中的資料
• Windows Form DataGridView 控制項中的儲存格樣式