DataGridViewCellStyle.NullValue 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 di visualizzazione della DataGridView cella corrispondente a un valore di cella pari Value a 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, setPublic Property NullValue As ObjectValore della proprietà
Oggetto utilizzato per indicare un valore Null in una cella. Il valore predefinito è Empty.
- Attributi
Esempio
Nell'esempio di codice seguente viene illustrato l'utilizzo di questa proprietà. In questo esempio, un DataGridView.CellFormatting gestore eventi visualizza il valore della proprietà quando il valore della NullValue 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.
Annotazioni
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 di celle o immagini di caselle di testo per l'uso da parte delle celle dell'immagine.
