DataGridViewCellStyle.NullValue Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ottiene o imposta il valore di visualizzazione delle celle di DataGridView corrispondente al valore Value o 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))]
public object? NullValue { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.NullValue : obj with get, set
Public Property NullValue As Object

Valore della proprietà

Object

Oggetto utilizzato per indicare un valore null in una cella. Il valore predefinito è Empty.

Attributi
TypeConverterAttribute

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questa proprietà. In questo esempio, un DataGridView.CellFormatting gestore eventi visualizza il valore della NullValue proprietà quando il valore della cella è uguale a 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

Commenti

Quando una DataGridView cella con questo stile di cella ha un valore o nullDBNull.Value o l'utente modifica la cella e preme CTRL+0, il DataGridView controllo visualizza il valore della NullValue proprietà. Quando un utente modifica una cella con questo stile di cella e immette il valore di questa proprietà o preme CTRL+0, il controllo imposta il valore della cella sul valore della DataSourceNullValue proprietà o su null se DataSourceNullValue è DBNull.Value e la cella ValueType è un tipo riferimento. Questa conversione non si verifica quando si imposta la DataGridViewCell.Value proprietà a livello di codice.

Nota

Il controllo non visualizza il valore della NullValue proprietà per i valori di cella uguali al valore della DataSourceNullValue proprietà quando DataSourceNullValue è impostato su un valore diverso da DBNull.Value o null. In questo caso, è possibile gestire l'evento DataGridView.CellFormatting per visualizzare il valore della NullValue proprietà. Per altre informazioni, vedere l'esempio di codice in questo argomento.

Questa proprietà accetta qualsiasi oggetto, che consente di specificare un valore con un tipo appropriato per il tipo di visualizzazione della cella. Ad esempio, è possibile impostare questa proprietà su valori stringa per l'uso da parte delle celle o delle immagini delle caselle di testo da usare nelle celle dell'immagine.

Si applica a

Vedi anche