Nullable<T> Nullable<T> Nullable<T> Nullable<T> Struct

Définition

Représente un type valeur qui peut avoir la valeur null.Represents a value type that can be assigned null.

generic <typename T>
 where T : value classpublic value class Nullable
[System.Serializable]
public struct Nullable<T> where T : struct
type Nullable<'T (requires 'T : struct)> = struct
Public Structure Nullable(Of T)

Paramètres de type

T

Type valeur sous-jacent du type Nullable<T> générique.The underlying value type of the Nullable<T> generic type.

Héritage
Nullable<T>Nullable<T>Nullable<T>Nullable<T>
Attributs

Exemples

L’exemple de code suivant définit trois lignes d’une table dans la base de données Pubs de Microsoft.The following code example defines three rows of a table in the Microsoft Pubs sample database. Le tableau contient deux colonnes qui ne sont pas nullables et deux colonnes qui acceptent des valeurs NULL.The table contains two columns that are not nullable and two columns that are nullable.

using namespace System;

// Define the "titleAuthor" table of the Microsoft "pubs" database.
value struct titleAuthor
{
    public:
       // Author ID; format ###-##-####
       String^ au_id;
       // Title ID; format AA####
       String^ title_id;
       // Author ORD is nullable.
       Nullable<short> au_ord;
       // Royalty Percent is nullable.
       Nullable<int> royaltyper;

    // Display the values of the titleAuthor array elements.
    static void Display(String^ dspTitle,
                        array<titleAuthor>^ dspAllTitleAuthors)
    {
       Console::WriteLine("*** {0} ***", dspTitle);
       for each (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.HasValue ?
                             dspTA.au_ord.Value : -1);
          Console::WriteLine("Royalty % ... {0}", dspTA.royaltyper.HasValue ?
                             dspTA.royaltyper.Value : 0);
          Console::WriteLine();
       }
    }
};

void main()
{
    // Declare and initialize the titleAuthor array.
    array<titleAuthor>^ ta = gcnew array<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 = nullptr;
//    ta[1].royaltyper = nullptr;

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

   // Display the values of the array elements, and
   // display a legend.
    titleAuthor::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.");
}
// 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.
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.
Class Sample
    ' Define the "titleAuthor" table of the Microsoft "pubs" database. 
    Public Structure titleAuthor
       ' Author ID; format ###-##-####
        Public au_id As String
        ' Title ID; format AA####
        Public title_id As String
        ' Author ORD is nullable.
        Public au_ord As Nullable(Of Short)
        ' Royalty Percent is nullable.
        Public royaltyper As Nullable(Of Integer)
    End Structure 
    
    Public Shared Sub Main() 
       ' Declare and initialize the titleAuthor array.
        Dim ta(2) As titleAuthor
        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 = Nothing
        ta(1).royaltyper = Nothing
        
        ta(2).au_id = "672-71-3249"
        ta(2).title_id = "TC7777"
        ta(2).au_ord = Nothing
        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.")
    End Sub
    
    ' Display the values of the titleAuthor array elements.
    Public Shared Sub Display(ByVal dspTitle As String, _
                              ByVal dspAllTitleAuthors() As titleAuthor) 
        Console.WriteLine("*** {0} ***", dspTitle)
        Dim dspTA As titleAuthor
        For Each 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.GetValueOrDefault(-1))
            Console.WriteLine("Royalty % ... {0}", dspTA.royaltyper.GetValueOrDefault(0))
            Console.WriteLine()
        Next 
    End Sub
End Class 
'This 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

Un type est dit nullable si elle peut être affectée à une valeur ou peut être affectée null, ce qui signifie que le type n’a aucune valeur.A type is said to be nullable if it can be assigned a value or can be assigned null, which means the type has no value whatsoever. Par défaut, tous les types référencent, tels que String, sont nullable, mais toutes les valeurs de types, tels que Int32, ne sont pas.By default, all reference types, such as String, are nullable, but all value types, such as Int32, are not.

En c# et Visual Basic, vous marquez un type valeur Nullable à l’aide de la ? notation après le type de valeur.In C# and Visual Basic, you mark a value type as nullable by using the ? notation after the value type. Par exemple, int? en c# ou Integer? en Visual Basic déclare un type de valeur d’entier qui peut être affecté null.For example, int? in C# or Integer? in Visual Basic declares an integer value type that can be assigned null.

Le Nullable<T> structure prend en charge uniquement un type valeur comme un type nullable, car les types référence sont nullables de conception.The Nullable<T> structure supports using only a value type as a nullable type because reference types are nullable by design.

Le Nullable classe fournit une prise en charge complémentaire pour le Nullable<T> structure.The Nullable class provides complementary support for the Nullable<T> structure. Le Nullable classe prend en charge l’obtention du type sous-jacent d’un type nullable, et les opérations de comparaison et d’égalité sur les paires de types nullables dont sous-jacent de type valeur ne prend pas en charge des opérations de comparaison et d’égalité génériques.The Nullable class supports obtaining the underlying type of a nullable type, and comparison and equality operations on pairs of nullable types whose underlying value type does not support generic comparison and equality operations.

Propriétés fondamentalesFundamental Properties

Les deux membres fondamentaux de la Nullable<T> structure sont les HasValue et Value propriétés.The two fundamental members of the Nullable<T> structure are the HasValue and Value properties. Si le HasValue propriété pour un Nullable<T> objet est true, la valeur de l’objet est accessible avec la Value propriété.If the HasValue property for a Nullable<T> object is true, the value of the object can be accessed with the Value property. Si le HasValue propriété est false, la valeur de l’objet n’est pas définie et une tentative d’accès à la Value propriété lève une InvalidOperationException.If the HasValue property is false, the value of the object is undefined and an attempt to access the Value property throws an InvalidOperationException.

Conversion boxing et unboxingBoxing and Unboxing

Lorsqu’un type nullable est boxed, le common language runtime boîtes automatiquement la valeur sous-jacente de la Nullable<T> de l’objet, pas le Nullable<T> objet lui-même.When a nullable type is boxed, the common language runtime automatically boxes the underlying value of the Nullable<T> object, not the Nullable<T> object itself. Autrement dit, si le HasValue propriété est true, le contenu de la Value propriété est boxed.That is, if the HasValue property is true, the contents of the Value property is boxed. Lorsque la valeur sous-jacente d’un type nullable est unboxed, le common language runtime crée un nouveau Nullable<T> structure initialisée à la valeur sous-jacente.When the underlying value of a nullable type is unboxed, the common language runtime creates a new Nullable<T> structure initialized to the underlying value.

Si le HasValue propriété d’un type nullable est false, le résultat d’une opération de boxing est null.If the HasValue property of a nullable type is false, the result of a boxing operation is null. Par conséquent, si un type nullable boxed est passé à une méthode qui attend un argument d’objet, cette méthode doit être prête à gérer le cas où l’argument est null.Consequently, if a boxed nullable type is passed to a method that expects an object argument, that method must be prepared to handle the case where the argument is null. Lorsque null est unboxed dans un type nullable, le common language runtime crée un Nullable<T> structure et l’initialise sa HasValue propriété false.When null is unboxed into a nullable type, the common language runtime creates a new Nullable<T> structure and initializes its HasValue property to false.

.NET Framework 4.5.1.NET Framework 4.5.1 et les composants Windows Runtimeand Windows Runtime Components

En commençant par le .NET Framework 4.5.1.NET Framework 4.5.1, vous pouvez inclure un Nullable<T> type en tant que membre d’une structure exportée dans une bibliothèque WinMD.Starting with the .NET Framework 4.5.1.NET Framework 4.5.1, you can include a Nullable<T> type as a member of a structure exported in a WinMD library. Auparavant, cela a été pas pris en charge.Previously, this was not supported.

Constructeurs

Nullable<T>(T) Nullable<T>(T) Nullable<T>(T) Nullable<T>(T)

Initialise une nouvelle instance de la structure Nullable<T> avec la valeur spécifiée.Initializes a new instance of the Nullable<T> structure to the specified value.

Propriétés

HasValue HasValue HasValue HasValue

Obtient une valeur indiquant si l'objet Nullable<T> actuel a une valeur valide de son type sous-jacent.Gets a value indicating whether the current Nullable<T> object has a valid value of its underlying type.

Value Value Value Value

Obtient la valeur de l'objet Nullable<T> actuel s'il a lui été assigné une valeur sous-jacente valide.Gets the value of the current Nullable<T> object if it has been assigned a valid underlying value.

Méthodes

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Indique si l'objet Nullable<T> en cours est égal à un objet spécifié.Indicates whether the current Nullable<T> object is equal to a specified object.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Récupère le code de hachage de l'objet retourné par la propriété Value.Retrieves the hash code of the object returned by the Value property.

GetValueOrDefault() GetValueOrDefault() GetValueOrDefault() GetValueOrDefault()

Récupère la valeur de l’objet Nullable<T> actuel ou la valeur par défaut du type sous-jacent.Retrieves the value of the current Nullable<T> object, or the default value of the underlying type.

GetValueOrDefault(T) GetValueOrDefault(T) GetValueOrDefault(T) GetValueOrDefault(T)

Récupère la valeur de l'objet Nullable<T> actuel ou la valeur par défaut spécifiée.Retrieves the value of the current Nullable<T> object, or the specified default value.

ToString() ToString() ToString() ToString()

Retourne la représentation textuelle de la valeur de l'objet Nullable<T> actuel.Returns the text representation of the value of the current Nullable<T> object.

Opérateurs

Explicit(Nullable<T> to T) Explicit(Nullable<T> to T) Explicit(Nullable<T> to T) Explicit(Nullable<T> to T)

Définit une conversion explicite d’une instance Nullable<T> à sa valeur sous-jacente.Defines an explicit conversion of a Nullable<T> instance to its underlying value.

Implicit(T to Nullable<T>) Implicit(T to Nullable<T>) Implicit(T to Nullable<T>) Implicit(T to Nullable<T>)

Crée un objet Nullable<T> initialisé à une valeur spécifiée.Creates a new Nullable<T> object initialized to a specified value.

S’applique à

Voir aussi