DataGridViewCellStyle.NullValue Özellik

  • Başvuru

Tanım

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

veya hücre değerine karşılık gelen hücre görüntüleme değerini Value alır veya nullayarlarDataGridView.

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

Özellik Değeri

Object

Bir hücredeki null değeri belirtmek için kullanılan nesne. Varsayılan değer: Empty.

Öznitelikler
TypeConverterAttribute

Örnekler

Aşağıdaki kod örneğinde bu özelliğin kullanımı gösterilmektedir. Bu örnekte, DataGridView.CellFormatting bir 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

Bu hücre stiline sahip bir DataGridView hücrenin DBNull.Value değeri veya null olduğunda veya kullanıcı hücreyi düzenleyip CTRL+0 tuşlarına bastığında DataGridView , denetim özellik değerini görüntüler NullValue . Kullanıcı bu hücre stiline sahip bir hücreyi düzenlediğinde ve bu özelliğin değerini girdiğinde veya CTRL+0 tuşlarına bastığında, denetim hücre değerini özelliğin DataSourceNullValue değerine veya null olup olmadığını ve hücrenin ValueType başvuru türü olup olmadığını DataSourceNullValueDBNull.Value ayarlar. Özelliği program aracılığıyla ayarladığınızda DataGridViewCell.Value bu dönüştürme gerçekleşmez.

Not

denetimi, veya nulldışında bir değere DataSourceNullValue ayarlandığında özellik değerine eşit hücre değerlerinin DataSourceNullValue özellik değerini görüntülemez NullValueDBNull.Value. 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.

Bu özellik, hücrenin görüntüleme türüne uygun bir türe sahip bir değer belirtmenize olanak tanıyan herhangi bir nesneyi alır. Örneğin, bu özelliği metin kutusu hücreleri veya görüntü hücreleri tarafından kullanılacak görüntüler tarafından kullanılacak dize değerlerine ayarlayabilirsiniz.

Şunlara uygulanır

Ayrıca bkz.