DataGridViewCellStyle.DataSourceNullValue Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera lub ustawia wartość zapisaną w źródle danych, gdy użytkownik wprowadzi wartość null do komórki.

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)]
public object? DataSourceNullValue { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.DataSourceNullValue : obj with get, set
Public Property DataSourceNullValue As Object

Wartość właściwości

Object

Wartość zapisana w źródle danych, gdy użytkownik określa wartość komórki o wartości null. Wartość domyślna to Value.

Atrybuty
BrowsableAttribute

Przykłady

Poniższy przykład kodu ilustruje użycie tej właściwości. W tym przykładzie DataGridView.CellFormatting program obsługi zdarzeń wyświetla wartość NullValue właściwości, gdy wartość komórki jest DataSourceNullValuerówna .

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

Uwagi

Użytkownik może wprowadzić wartość null do komórki, naciskając klawisze CTRL+0 lub wpisując wartość NullValue właściwości. Gdy użytkownik zatwierdzi zmianę, wartość komórki bazowej jest ustawiona na wartość DataSourceNullValue właściwości lub null , jeśli DataSourceNullValue jest DBNull.Value , a komórka ValueType jest typem odwołania. Ta konwersja nie występuje podczas programowego ustawiania DataGridViewCell.Value właściwości.

Uwaga

Kontrolka nie wyświetla NullValue wartości właściwości dla wartości komórek równej DataSourceNullValue wartości właściwości, gdy DataSourceNullValue jest ustawiona na wartość inną niż DBNull.Value lub null. W takim przypadku można obsłużyć DataGridView.CellFormatting zdarzenie, aby wyświetlić NullValue wartość właściwości. Aby uzyskać więcej informacji, zobacz przykładowy kod w tym temacie.

Dotyczy

Zobacz też