DataGridViewCellStyle.NullValue Egenskap

Definition

Hämtar eller anger det cellvisningsvärde DataGridView som motsvarar ett cellvärde för Value eller 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, set
Public Property NullValue As Object

Egenskapsvärde

Objektet som används för att ange ett null-värde i en cell. Standardvärdet är Empty.

Attribut

Exempel

Följande kodexempel illustrerar användningen av den här egenskapen. I det här exemplet visar en DataGridView.CellFormatting händelsehanterare värdet för NullValue egenskapen när cellvärdet är DataSourceNullValuelika med .

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

Kommentarer

När en DataGridView cell med det här cellformatet har värdet DBNull.Value eller null om användaren redigerar cellen och trycker på CTRL+0 DataGridView , visar kontrollen egenskapsvärdet NullValue . När en användare redigerar en cell med det här cellformatet och anger värdet för den här egenskapen eller trycker på CTRL+0, anger kontrollen cellvärdet till värdet DataSourceNullValue för egenskapen eller till null om DataSourceNullValue är DBNull.Value och cellen ValueType är en referenstyp. Den här konverteringen DataGridViewCell.Value sker inte när du ställer in egenskapen programmatiskt.

Note

Kontrollen visar inte egenskapsvärdet NullValue för cellvärden som är lika med egenskapsvärdet DataSourceNullValue när DataSourceNullValue är inställt på ett annat värde än DBNull.Value eller null. I det här fallet kan du hantera DataGridView.CellFormatting händelsen för att visa egenskapsvärdet NullValue . Mer information finns i kodexemplet i det här avsnittet.

Den här egenskapen tar alla objekt, vilket gör att du kan ange ett värde med en typ som är lämplig för cellens visningstyp. Du kan till exempel ställa in den här egenskapen på strängvärden som ska användas av textruteceller eller bilder som ska användas av bildceller.

Gäller för

Se även