DataGridViewCellStyle.DataSourceNullValue Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DataGridViewCellStyle.cs

Získá nebo nastaví hodnotu uloženou do zdroje dat, když uživatel zadá hodnotu null do buňky.

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)>]
member this.DataSourceNullValue : obj with get, set

Public Property DataSourceNullValue As Object

Hodnota vlastnosti

Object

Hodnota uložená do zdroje dat, když uživatel určuje hodnotu buňky null. Výchozí hodnota je Value.

Atributy

BrowsableAttribute

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

Uživatel může do buňky zadat hodnotu null stisknutím kombinace kláves CTRL+0 nebo zadáním hodnoty NullValue vlastnosti. Když uživatel potvrdí změnu, základní hodnota buňky je nastavena na hodnotu DataSourceNullValue vlastnosti nebo null je-li DBNull.ValueDataSourceNullValue 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.

Viz také

• DataGridView
• CellFormatting
• Value
• IsDataSourceNullValueDefault
• NullValue
• Styly buněk v ovládacím prvku Windows Forms DataGridView