DataGridViewCellStyle.NullValue Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de weergavewaarde van de DataGridView cel opgehaald of ingesteld die overeenkomt met een celwaarde van Value of 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, setPublic Property NullValue As ObjectWaarde van eigenschap
Het object dat wordt gebruikt om een null-waarde in een cel aan te geven. De standaardwaarde is Empty.
- 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
Wanneer een DataGridView cel met deze celstijl een waarde heeft van DBNull.Value of null de gebruiker de cel bewerkt en op Ctrl+0 drukt, wordt de DataGridViewNullValue eigenschapswaarde weergegeven. Wanneer een gebruiker een cel bewerkt met deze celstijl en de waarde van deze eigenschap invoert of op Ctrl+0 drukt, stelt het besturingselement de celwaarde in op de waarde van de DataSourceNullValue eigenschap of null op als DataSourceNullValue dat het DBNull.Value is 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.
Deze eigenschap gebruikt een object, waarmee u een waarde kunt opgeven met een type dat geschikt is voor het weergavetype van de cel. U kunt deze eigenschap bijvoorbeeld instellen op tekenreekswaarden voor gebruik door tekstvakcellen of afbeeldingen voor gebruik door afbeeldingscellen.
