DataGridViewCellStyle.NullValue Właściwość

  • Odwołanie

Definicja

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

Pobiera lub ustawia wartość wyświetlaną DataGridView komórki odpowiadającą wartości komórki lub Valuenull.

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

Wartość właściwości

Object

Obiekt używany do wskazywania wartości null w komórce. Wartość domyślna to Empty.

Atrybuty
TypeConverterAttribute

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 równa 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

Uwagi

DataGridView Gdy komórka z tym stylem komórki ma wartość DBNull.Value lub null użytkownik edytuje komórkę i naciska klawisze CTRL+0, DataGridView kontrolka wyświetla NullValue wartość właściwości. Gdy użytkownik edytuje komórkę za pomocą tego stylu komórki i wprowadza wartość tej właściwości lub naciska klawisze CTRL+0, kontrolka ustawia wartość komórki 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 po ustawieniu DataGridViewCell.Value właściwości programowo.

Uwaga

Kontrolka nie wyświetla NullValue wartości właściwości dla wartości komórek równych 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ład kodu w tym temacie.

Ta właściwość przyjmuje dowolny obiekt, który umożliwia określenie wartości o typie odpowiednim dla typu wyświetlanego komórki. Można na przykład ustawić tę właściwość na wartości ciągów do użycia przez komórki pola tekstowego lub obrazy do użycia przez komórki obrazów.

Dotyczy

Zobacz też