Share via

DataGridViewCellStyle.NullValue Properti

  • Referensi

Definisi

Ruang nama:
System.Windows.Forms
Rakitan:
System.Windows.Forms.dll

Mendapatkan atau mengatur DataGridView nilai tampilan sel yang terkait dengan nilai Value sel atau 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))]
public object? NullValue { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.NullValue : obj with get, set
Public Property NullValue As Object

Nilai Properti

Object

Objek yang digunakan untuk menunjukkan nilai null dalam sel. Default adalah Empty.

Atribut
TypeConverterAttribute

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

DataGridView Saat sel dengan gaya sel ini memiliki nilai DBNull.Value atau null atau pengguna mengedit sel dan menekan CTRL+0, DataGridView kontrol akan menampilkan NullValue nilai properti. Saat pengguna mengedit sel dengan gaya sel ini dan memasukkan nilai properti ini atau menekan CTRL+0, kontrol mengatur nilai sel ke nilai DataSourceNullValue properti atau jika nullDataSourceNullValue adalah DBNull.Value dan sel ValueType adalah tipe 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.

Properti ini mengambil objek apa pun, yang memungkinkan Anda menentukan nilai dengan jenis yang sesuai dengan tipe tampilan sel. Misalnya, Anda dapat mengatur properti ini ke nilai string untuk digunakan oleh sel atau gambar kotak teks untuk digunakan oleh sel gambar.

Berlaku untuk

Lihat juga