DataGridViewCellStyle.DataSourceNullValue Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Kullanıcı bir hücreye null değer girdiğinde veri kaynağına kaydedilen değeri alır veya ayarlar.

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

Özellik Değeri

Object

Kullanıcı null bir hücre değeri belirttiğinde veri kaynağına kaydedilen değer. Varsayılan değer: Value.

Öznitelikler
BrowsableAttribute

Örnekler

Aşağıdaki kod örneği bu özelliğin kullanımını gösterir. Bu örnekte, bir DataGridView.CellFormatting olay işleyicisi hücre değeri NullValue eşit DataSourceNullValueolduğunda özelliğinin değerini görüntüler.

// 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

Açıklamalar

Kullanıcı, CTRL+0 tuşlarına basarak veya özelliğinin değerini yazarak hücreye NullValue null değer girebilir. Kullanıcı değişikliği işlediğinde, temel alınan hücre değeri özelliğin DataSourceNullValue değerine veya null ise DataSourceNullValue ve hücre ValueType bir başvuru türüyse DBNull.Value olarak ayarlanır. Özelliği program aracılığıyla ayarladığınızda DataGridViewCell.Value bu dönüştürme gerçekleşmez.

Not

veya dışında DBNull.Valuenullbir değere NullValueDataSourceNullValue ayarlandığında denetim, özellik değerine DataSourceNullValue eşit hücre değerleri için özellik değerini görüntülemez. Bu durumda, özellik değerini görüntülemek NullValue için olayı işleyebilirsinizDataGridView.CellFormatting. Daha fazla bilgi için bu konudaki kod örneğine bakın.

Şunlara uygulanır

Ayrıca bkz.