Partager via

Comment : créer un type Nullable (Concepteur de classes)

  • Article

Certains types valeur ne disposent pas toujours (ou n'ont pas toujours besoin) d'une valeur définie. Cela est courant dans les bases de données, où certains champs n'ont parfois aucune valeur assignée. Par exemple, vous pouvez assigner une valeur Null à un champ de base de données pour indiquer qu'aucune valeur ne lui a encore été assignée.

Un type Nullable est un type valeur que vous étendez afin qu'il prenne la plage des valeurs de ce type ainsi qu'une valeur Null. Par exemple, un type Nullable Int32 (Nullable<Int32>), peut avoir une valeur comprise entre -2147483648 et 2147483647, ou une valeur Null. Un Nullable <bool> peut se voir assigner les valeurs True, False ou null (aucune valeur).

Les types Nullable sont des instances de la structure Nullable. Chaque instance de type Nullable a deux propriétés publiques en lecture seule, HasValue et Value :

  • HasValue est de type bool et indique si la variable contient une valeur définie. True signifie que la variable contient une valeur non null. Vous pouvez tester une valeur définie à l'aide d'une instruction telle que if (x.HasValue) ou if (y != null).

  • Value est du même type que le type sous-jacent. Si HasValue a la valeur True, Value contient une valeur significative. Si HasValue est False, l'accès à Value lèvera une exception d'opération incorrecte.

Par défaut, lorsque vous déclarez une variable en tant que type Nullable, aucune valeur n'est définie (HasValue est False), à part la valeur par défaut de son type valeur sous-jacent.

Le concepteur de classes affiche un type Nullable comme il affiche son type sous-jacent.

Pour plus d'informations sur les types qui autorisent la valeur Null en Visual C#, consultez Types Nullable (Guide de programmation C#). Pour plus d'informations sur les types qui autorisent la valeur Null en Visual Basic, consultez Types valeur Nullable (Visual Basic).

Notes

Il est possible que pour certains des éléments de l'interface utilisateur de Visual Studio, votre ordinateur affiche des noms ou des emplacements différents de ceux indiqués dans les instructions suivantes. L'édition de Visual Studio dont vous disposez et les paramètres que vous utilisez déterminent ces éléments. Pour plus d'informations, voir Paramètres Visual Studio.

Pour ajouter un type Nullable à l'aide du concepteur de classes

  1. Dans le diagramme de classes, développez une classe existante ou créez une nouvelle classe.

  2. Pour ajouter une classe au projet, cliquez sur Ajouter dans le menu Diagramme de classes, puis cliquez sur Ajouter une classe.

  3. Pour développer la forme de classe, dans le menu Diagramme de classes, cliquez sur Développer.

  4. Sélectionnez la forme de classe. Dans le menu Diagramme de classes, cliquez sur Ajouter, puis sur Champ. Un nouveau champ avec le nom par défaut Champ apparaît dans la forme de classe et dans la fenêtre Détails de classe.

  5. Dans la colonne Nom de la fenêtre Détails de classe (ou dans la forme de classe elle-même), remplacez le nom du nouveau champ par un nom valide et explicite.

  6. Dans la colonne Type de la fenêtre Détails de classe, déclarez le type en tant que type Nullable, comme indiqué dans le code suivant :

    // Declare a nullable type in Visual C#:
class Test
{
   int? building_number = 5;
}

    ' Declare a nullable type in Visual Basic:
Class Test
   Dim buildingNumber As Nullable(Of Integer) = 5
End Class

Pour ajouter un type Nullable en utilisant l'Éditeur de code

  1. Ajoutez une classe au projet. Sélectionnez le nœud de projet dans l'Explorateur de solutions puis, dans le menu Projet, cliquez sur Ajouter une classe.

  2. Dans le fichier .cs ou .vb pour la nouvelle classe, ajoutez un ou plusieurs types Nullable de la nouvelle classe à la déclaration de classe.

  3. Dans l'affichage de classes, faites glisser l'icône de la nouvelle classe vers l'aire de conception du concepteur de classes. Une forme de classe apparaît dans le diagramme de classes.

  4. Développez les détails pour la forme de classe et déplacez le pointeur de la souris sur les membres de la classe. L'info-bulle affiche la déclaration de chaque membre.

  5. Cliquez avec le bouton droit sur la forme de classe, puis cliquez sur Détails de classe. Vous pouvez afficher ou modifier les propriétés du nouveau type dans la fenêtre Détails de classe.

Voir aussi

Tâches

Comment : identifier un type Nullable (Guide de programmation C#)

Référence

Types Nullable (Guide de programmation C#)

Utilisation de types Nullable (Guide de programmation C#)

Nullable

Concepts

Types valeur Nullable (Visual Basic)