DataGridViewCellStyle.NullValue Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

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í formát je Empty.

Atributy

TypeConverterAttribute

Příklady

Následující příklad kódu znázorňuje použití této vlastnosti. V tomto příkladu obslužná rutina DataGridView.CellFormatting 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 ji uživatel upraví a stiskne kombinaci kláves CTRL+0, DataGridView ovládací prvek zobrazí NullValue 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, ovládací prvek nastaví hodnotu buňky na hodnotu vlastnosti nebo na null hodnotu DataSourceNullValue 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 buňky rovnající se hodnotě DataSourceNullValue vlastnosti, pokud DataSourceNullValue je nastavena na jinou hodnotu než DBNull.Value nebo null. V tomto případě můžete zpracovat DataGridView.CellFormatting událost a zobrazit NullValue hodnotu vlastnosti. Další informace najdete v příkladu kódu v tomto tématu.

Tato vlastnost přijímá jakýkoli 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í v buňkách textového pole nebo obrázky pro buňky obrázků.

Viz také

• DataGridView
• CellFormatting
• Value
• DataSourceNullValue
• IsDataSourceNullValueDefault
• Postupy: Formátování dat v ovládacím prvku Windows Forms DataGridView
• Styly buňky v ovládacím prvku Windows Forms DataGridView