Lire en anglais

Partager via


Nullable<T> Structure

Définition

Représente un type valeur qui peut avoir la valeur null.

C#
public struct Nullable<T> where T : struct
C#
[System.Serializable]
public struct Nullable<T> where T : struct

Paramètres de type

T

Type valeur sous-jacent du type Nullable<T> générique.

Héritage
Nullable<T>
Attributs

Exemples

L’exemple de code suivant définit trois lignes d’une table dans l’exemple de base de données Microsoft Pubs. La table contient deux colonnes qui ne peuvent pas avoir la valeur Null et deux colonnes qui peuvent avoir la valeur Null.

C#
using System;

class Sample
{
    // Define the "titleAuthor" table of the Microsoft "pubs" database.
    public struct titleAuthor
    {
      // Author ID; format ###-##-####
      public string au_id;
      // Title ID; format AA####
      public string title_id;
      // Author ORD is nullable.
      public short? au_ord;
      // Royalty Percent is nullable.
      public int? royaltyper;
    }

    public static void Main()
    {
      // Declare and initialize the titleAuthor array.
      titleAuthor[] ta = new titleAuthor[3];
      ta[0].au_id = "712-32-1176";
      ta[0].title_id = "PS3333";
      ta[0].au_ord = 1;
      ta[0].royaltyper = 100;

      ta[1].au_id = "213-46-8915";
      ta[1].title_id = "BU1032";
      ta[1].au_ord = null;
      ta[1].royaltyper = null;

      ta[2].au_id = "672-71-3249";
      ta[2].title_id = "TC7777";
      ta[2].au_ord = null;
      ta[2].royaltyper = 40;

      // Display the values of the titleAuthor array elements, and
      // display a legend.
      Display("Title Authors Table", ta);
      Console.WriteLine("Legend:");
      Console.WriteLine("An Author ORD of -1 means no value is defined.");
      Console.WriteLine("A Royalty % of 0 means no value is defined.");
    }

    // Display the values of the titleAuthor array elements.
    public static void Display(string dspTitle,
                               titleAuthor[] dspAllTitleAuthors)
    {
      Console.WriteLine("*** {0} ***", dspTitle);
      foreach (titleAuthor dspTA in dspAllTitleAuthors) {
         Console.WriteLine("Author ID ... {0}", dspTA.au_id);
         Console.WriteLine("Title ID .... {0}", dspTA.title_id);
         Console.WriteLine("Author ORD .. {0}", dspTA.au_ord ?? -1);
         Console.WriteLine("Royalty % ... {0}", dspTA.royaltyper ?? 0);
         Console.WriteLine();
      }
    }
}
// The example displays the following output:
//     *** Title Authors Table ***
//     Author ID ... 712-32-1176
//     Title ID .... PS3333
//     Author ORD .. 1
//     Royalty % ... 100
//
//     Author ID ... 213-46-8915
//     Title ID .... BU1032
//     Author ORD .. -1
//     Royalty % ... 0
//
//     Author ID ... 672-71-3249
//     Title ID .... TC7777
//     Author ORD .. -1
//     Royalty % ... 40
//
//     Legend:
//     An Author ORD of -1 means no value is defined.
//     A Royalty % of 0 means no value is defined.

Remarques

Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour nullable<T>.

Constructeurs

Nullable<T>(T)

Initialise une nouvelle instance de la structure Nullable<T> avec la valeur spécifiée.

Propriétés

HasValue

Obtient une valeur indiquant si l'objet Nullable<T> actuel a une valeur valide de son type sous-jacent.

Value

Obtient la valeur de l'objet Nullable<T> actuel si une valeur sous-jacente valide lui a été assignée.

Méthodes

Equals(Object)

Indique si l'objet Nullable<T> en cours est égal à un objet spécifié.

GetHashCode()

Récupère le code de hachage de l'objet retourné par la propriété Value.

GetValueOrDefault()

Récupère la valeur de l’objet Nullable<T> actuel ou la valeur par défaut du type sous-jacent.

GetValueOrDefault(T)

Récupère la valeur de l'objet Nullable<T> actuel ou la valeur par défaut spécifiée.

ToString()

Retourne la représentation textuelle de la valeur de l'objet Nullable<T> actuel.

Opérateurs

Explicit(Nullable<T> to T)

Définit une conversion explicite d’une instance Nullable<T> à sa valeur sous-jacente.

Implicit(T to Nullable<T>)

Crée un objet Nullable<T> initialisé à une valeur spécifiée.

S’applique à

Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Voir aussi