DataGridViewCellStyle.DataSourceNullValue Eigenschap

Definitie

Hiermee wordt de waarde opgehaald of ingesteld die is opgeslagen in de gegevensbron wanneer de gebruiker een null-waarde invoert in een cel.

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

Waarde van eigenschap

De waarde die is opgeslagen in de gegevensbron wanneer de gebruiker een null-celwaarde opgeeft. De standaardwaarde is Value.

Kenmerken

Voorbeelden

Het volgende codevoorbeeld illustreert het gebruik van deze eigenschap. In dit voorbeeld geeft een DataGridView.CellFormatting gebeurtenishandler de waarde van de NullValue eigenschap weer wanneer de celwaarde gelijk is DataSourceNullValueaan .

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

Opmerkingen

De gebruiker kan een null-waarde invoeren in een cel door op Ctrl+0 te drukken of door de waarde van de NullValue eigenschap te typen. Wanneer de gebruiker de wijziging doorvoert, wordt de onderliggende celwaarde ingesteld op de waarde van de DataSourceNullValue eigenschap of op null als DataSourceNullValue dat het is DBNull.Value en de cel ValueType een verwijzingstype is. Deze conversie vindt niet plaats wanneer u de DataGridViewCell.Value eigenschap programmatisch instelt.

Note

In het besturingselement wordt de NullValue eigenschapswaarde voor celwaarden niet weergegeven die gelijk is aan de DataSourceNullValue eigenschapswaarde wanneer DataSourceNullValue deze is ingesteld op een andere waarde dan DBNull.Value of null. In dit geval kunt u de DataGridView.CellFormatting gebeurtenis afhandelen om de NullValue eigenschapswaarde weer te geven. Zie het codevoorbeeld in dit onderwerp voor meer informatie.

Van toepassing op

Zie ook