DataGridViewCellStyle.DataSourceNullValue Properti
Definisi
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 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)]
public object? DataSourceNullValue { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.DataSourceNullValue : obj with get, set
Public Property DataSourceNullValue As Object
Nilai Properti
Nilai yang disimpan ke sumber data saat pengguna menentukan nilai sel null. Default adalah Value.
- Atribut
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.