DataGridViewCellStyle.NullValue Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit la DataGridView valeur d’affichage de cellule correspondant à une valeur de cellule de Value ou 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 ObjectValeur de propriété
Objet utilisé pour indiquer une valeur Null dans une cellule. La valeur par défaut est Empty.
- Attributs
Exemples
L’exemple de code suivant illustre l’utilisation de cette propriété. Dans cet exemple, un gestionnaire d’événements DataGridView.CellFormatting affiche la valeur de la NullValue propriété lorsque la valeur de cellule est égale 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
Remarques
Lorsqu’une DataGridView cellule avec ce style de cellule a une valeur ou nullDBNull.Value si l’utilisateur modifie la cellule et appuie sur Ctrl+0, le DataGridView contrôle affiche la NullValue valeur de propriété. Lorsqu’un utilisateur modifie une cellule avec ce style de cellule et entre la valeur de cette propriété ou appuie sur Ctrl+0, le contrôle définit la valeur de la cellule sur la valeur de la DataSourceNullValue propriété ou sur null le cas DataSourceNullValueDBNull.Value où la cellule ValueType est un type référence. Cette conversion ne se produit pas lorsque vous définissez la DataGridViewCell.Value propriété par programmation.
Note
Le contrôle n’affiche pas la valeur de propriété pour les NullValue valeurs de cellule égales à la DataSourceNullValue valeur de propriété lorsqu’elle DataSourceNullValue est définie sur une valeur autre que DBNull.Value ou null. Dans ce cas, vous pouvez gérer l’événement DataGridView.CellFormatting pour afficher la valeur de la NullValue propriété. Pour plus d’informations, consultez l’exemple de code de cette rubrique.
Cette propriété accepte n’importe quel objet, qui vous permet de spécifier une valeur avec un type approprié au type d’affichage de la cellule. Par exemple, vous pouvez définir cette propriété sur des valeurs de chaîne à utiliser par des cellules de zone de texte ou des images à utiliser par des cellules d’image.
