DataGridViewCellStyle.DataSourceNullValue Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

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 zadá hodnotu buňky null. Výchozí formát je Value.

Atributy

BrowsableAttribute

Příklady

Následující příklad kódu ukazuje 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 změnu potvrdí, nastaví se hodnota základní 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, která se DataSourceNullValue rovná hodnotě vlastnosti, pokud DataSourceNullValue je nastavená na jinou hodnotu než DBNull.Value nebo null. V takovém 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.

Viz také

• DataGridView
• CellFormatting
• Value
• IsDataSourceNullValueDefault
• NullValue
• Styly buňky v ovládacím prvku Windows Forms DataGridView