Condividi tramite


DataGridViewCellStyle.DataSourceNullValue Proprietà

Definizione

Ottiene o imposta il valore salvato nell'origine dati quando l'utente immette un valore null in una cella.

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

Valore della proprietà

Valore salvato nell'origine dati quando l'utente specifica un valore null per una cella. Il valore predefinito è Value.

Attributi

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

L'utente può immettere un valore Null in una cella premendo CTRL+0 o digitando il valore della NullValue proprietà. Quando l'utente esegue il commit della modifica, il valore della cella sottostante viene impostato 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.

Si applica a

Vedi anche