DataGridViewCellStyle.NullValue Właściwość

Definicja

Pobiera lub ustawia DataGridView wartość wyświetlaną komórki odpowiadającą wartości komórki Value lub null .Gets or sets the DataGridView cell display value corresponding to a cell value of Value or 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

Wartość właściwości

Object

Obiekt używany do wskazania wartości null w komórce.The object used to indicate a null value in a cell. Wartość domyślna to Empty.The default is Empty.

Atrybuty

Przykłady

Poniższy przykład kodu ilustruje użycie tej właściwości.The following code example illustrates the use of this property. 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 .In this example, a DataGridView.CellFormatting event handler displays the value of the NullValue property when the cell value equals 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

Gdy DataGridView komórka z tym stylem komórki ma wartość DBNull.Value lub null lub użytkownik edytuje komórkę i naciśnie kombinację klawiszy Ctrl + 0, DataGridView formant Wyświetla NullValue wartość właściwości.When a DataGridView cell with this cell style has a value of DBNull.Value or null or the user edits the cell and presses CTRL+0, the DataGridView control displays the NullValue property value. Gdy użytkownik edytuje komórkę z tym stylem komórki i wprowadza wartość tej właściwości lub naciśnie kombinację klawiszy CTRL + 0, formant ustawia wartość komórki na wartość DataSourceNullValue właściwości lub do null Jeśli DataSourceNullValue jest DBNull.Value , a komórka ValueType jest typem referencyjnym.When a user edits a cell with this cell style and enters the value of this property or presses CTRL+0, the control sets the cell value to the value of the DataSourceNullValue property or to null if DataSourceNullValue is DBNull.Value and the cell ValueType is a reference type. Ta konwersja nie występuje, gdy właściwość jest ustawiana DataGridViewCell.Value programowo.This conversion does not occur when you set the DataGridViewCell.Value property programmatically.

Uwaga

Kontrolka nie wyświetla NullValue wartości właściwości dla wartości komórki równej DataSourceNullValue wartości właściwości DataSourceNullValue , gdy jest ustawiona na wartość inną niż DBNull.Value lub null .The control does not display the NullValue property value for cell values equal to the DataSourceNullValue property value when DataSourceNullValue is set to a value other than DBNull.Value or null. W takim przypadku można obsłużyć DataGridView.CellFormatting zdarzenie, aby wyświetlić NullValue wartość właściwości.In this case, you can handle the DataGridView.CellFormatting event to display the NullValue property value. Aby uzyskać więcej informacji, zobacz przykład kodu w tym temacie.For more information, see the code example in this topic.

Ta właściwość przyjmuje każdy obiekt, który umożliwia określenie wartości z typem odpowiednim dla komórki.This property takes any object, which enables you to specify a value with a type appropriate to the display type of the cell. Na przykład można ustawić tę właściwość na wartości ciągu do użycia przez komórki pól tekstowych lub obrazy do użycia przez komórki obrazu.For example, you can set this property to string values for use by text box cells or images for use by image cells.

Dotyczy

Zobacz też