DataGridViewCellStyle.NullValue Properti

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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

Bagikan melalui