DataGridViewCellStyle.DataSourceNullValue Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Mendapatkan atau mengatur nilai yang disimpan ke sumber data saat pengguna memasukkan nilai null ke dalam sel.

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

Public Property DataSourceNullValue As Object

Nilai Properti

Object

Nilai yang disimpan ke sumber data saat pengguna menentukan nilai sel null. Default adalah Value.

Atribut

BrowsableAttribute

Contoh

Contoh kode berikut mengilustrasikan penggunaan properti ini. Dalam contoh ini, penanganan DataGridView.CellFormatting aktivitas menampilkan nilai NullValue properti saat nilai sel sama dengan 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

Keterangan

Pengguna dapat memasukkan nilai null ke dalam sel dengan menekan CTRL+0 atau dengan mengetikkan nilai NullValue properti. Saat pengguna melakukan perubahan, nilai sel yang mendasar diatur ke nilai DataSourceNullValue properti atau ke null jika DataSourceNullValue adalah DBNull.Value dan sel ValueType adalah jenis referensi. Konversi ini tidak terjadi ketika Anda mengatur properti secara terprogram DataGridViewCell.Value .

Catatan

Kontrol tidak menampilkan NullValue nilai properti untuk nilai sel yang sama dengan DataSourceNullValue nilai properti saat DataSourceNullValue diatur ke nilai selain DBNull.Value atau null. Dalam hal ini, Anda dapat menangani DataGridView.CellFormatting peristiwa untuk menampilkan NullValue nilai properti. Untuk informasi selengkapnya, lihat contoh kode dalam topik ini.

Lihat juga

• DataGridView
• CellFormatting
• Value
• IsDataSourceNullValueDefault
• NullValue
• Gaya Sel dalam Kontrol Formulir Windows DataGridView