DataGridViewCellStyle.DataSourceNullValue Proprietà

  • Riferimento

Definizione

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

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à

Object

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

Attributi
BrowsableAttribute

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