DataGridViewCellStyle.NullValue Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewCellStyle.cs

Získá nebo nastaví DataGridView hodnotu zobrazení buňky odpovídající hodnotě Value buňky nebo 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))>]
member this.NullValue : obj with get, set

Public Property NullValue As Object

Hodnota vlastnosti

Object

Objekt použitý k označení hodnoty null v buňce. Výchozí hodnota je Empty.

Atributy

TypeConverterAttribute

Příklady

Následující příklad kódu ilustruje použití této vlastnosti. V tomto příkladu obslužná DataGridView.CellFormatting rutina události zobrazí hodnotu NullValue vlastnosti, když se hodnota buňky rovná DataSourceNullValue.

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

Poznámky

DataGridView Pokud má buňka s tímto stylem buňky hodnotu DBNull.Value nebo null uživatel buňku upraví a stiskne ctrl+0, DataGridView zobrazí NullValue ovládací prvek hodnotu vlastnosti. Když uživatel upraví buňku s tímto stylem buňky a zadá hodnotu této vlastnosti nebo stiskne kombinaci kláves CTRL+0, nastaví ovládací prvek hodnotu buňky na hodnotu DataSourceNullValue vlastnosti nebo null pokud DataSourceNullValue je DBNull.Value a buňka ValueType je typ odkazu. K tomuto převodu nedojde při programovém DataGridViewCell.Value nastavení vlastnosti.

Poznámka:

Ovládací prvek nezobrazuje NullValue hodnotu vlastnosti pro hodnoty buněk, které DataSourceNullValue se rovnají hodnotě vlastnosti, pokud DataSourceNullValue je nastavena na jinou hodnotu než DBNull.Value nebo null. V tomto případě můžete zpracovat DataGridView.CellFormatting událost, která zobrazí NullValue hodnotu vlastnosti. Další informace najdete v příkladu kódu v tomto tématu.

Tato vlastnost přebírá libovolný objekt, který umožňuje zadat hodnotu s typem odpovídajícím typu zobrazení buňky. Tuto vlastnost můžete například nastavit na řetězcové hodnoty pro použití podle buněk textového pole nebo obrázků pro použití v buňkách obrázku.

Viz také

• DataGridView
• CellFormatting
• Value
• DataSourceNullValue
• IsDataSourceNullValueDefault
• Postupy: Formátování dat v ovládacím prvku Windows Forms DataGridView
• Styly buněk v ovládacím prvku Windows Forms DataGridView