DataGridViewCellStyle.DataSourceNullValue Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, setPublic Property DataSourceNullValue As ObjectValore 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.
