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

Definizione

Rappresenta un tipo di valore a cui può essere assegnato 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)

Parametri di tipo

T

Tipo di valore sottostante del tipo generico Nullable<T>.The underlying value type of the Nullable<T> generic type.

Ereditarietà
Nullable<T>Nullable<T>Nullable<T>Nullable<T>
Attributi

Esempi

L'esempio di codice seguente definisce tre righe di una tabella nel database di esempio Pubs Microsoft.The following code example defines three rows of a table in the Microsoft Pubs sample database. La tabella contiene due colonne che non sono nullable e due colonne che ammettono i valori 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.

Commenti

Un tipo viene definito che ammette valori null se questo può essere assegnato un valore o può essere assegnato null, ovvero il tipo non presenta alcun valore.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. Per impostazione predefinita, i tipi di riferimento, ad esempio String, sono nullable, ma tutti i valori di tipi, ad esempio Int32, non sono.By default, all reference types, such as String, are nullable, but all value types, such as Int32, are not.

In C# e Visual Basic, si contrassegna un tipo di valore come nullable mediante il ? notazione dopo il tipo di valore.In C# and Visual Basic, you mark a value type as nullable by using the ? notation after the value type. Ad esempio, int? in C# o Integer? in Visual Basic viene dichiarato un tipo di valore integer che può essere assegnato null.For example, int? in C# or Integer? in Visual Basic declares an integer value type that can be assigned null.

Il Nullable<T> struttura supporta l'uso solo di un tipo di valore come un tipo nullable perché i tipi di riferimento sono ammette valori null per impostazione predefinita.The Nullable<T> structure supports using only a value type as a nullable type because reference types are nullable by design.

Il Nullable classe fornisce supporto aggiuntivo per il Nullable<T> struttura.The Nullable class provides complementary support for the Nullable<T> structure. Il Nullable classe è possibile ottenere il tipo sottostante di un tipo nullable e operazioni di confronto e uguaglianza su una coppia di tipi nullable il cui tipo sottostante di tipo valore non supporta le operazioni di confronto e uguaglianza generiche.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.

Proprietà fondamentaliFundamental Properties

I due membri fondamentali del Nullable<T> struttura sono le HasValue e Value proprietà.The two fundamental members of the Nullable<T> structure are the HasValue and Value properties. Se il HasValue proprietà per un Nullable<T> oggetto viene true, il valore dell'oggetto, è possibile accedervi tramite il Value proprietà.If the HasValue property for a Nullable<T> object is true, the value of the object can be accessed with the Value property. Se il HasValue proprietà viene false, il valore dell'oggetto è definito e tenta di accedere al Value proprietà genera un 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.

Boxing e unboxingBoxing and Unboxing

Quando viene sottoposto a boxing di un tipo nullable, common language runtime caselle automaticamente il valore sottostante del Nullable<T> dell'oggetto, non il Nullable<T> oggetto stesso.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. Vale a dire, se il HasValue proprietà è true, il contenuto del Value proprietà è di tipo boxed.That is, if the HasValue property is true, the contents of the Value property is boxed. Quando il valore sottostante di un tipo nullable è unboxed, common language runtime crea un nuovo Nullable<T> struttura inizializzata sul valore sottostante.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.

Se il HasValue è di proprietà di un tipo nullable false, il risultato di un'operazione di conversione boxing è null.If the HasValue property of a nullable type is false, the result of a boxing operation is null. Di conseguenza, se un tipo nullable boxed viene passato a un metodo che prevede un argomento di oggetto, tale metodo deve essere preparato per gestire il caso in cui l'argomento è 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. Quando null è unboxed in un tipo nullable, common language runtime crea un nuovo Nullable<T> struttura e la inizializza relativo HasValue proprietà 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 e componenti Windows Runtimeand Windows Runtime Components

A partire da .NET Framework 4.5.1.NET Framework 4.5.1, è possibile includere un tipo Nullable<T> come membro di una struttura esportata in una libreria 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. In precedenza, tale operazione non era supportata.Previously, this was not supported.

Costruttori

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

Inizializza una nuova istanza della struttura Nullable<T> sul valore specificato.Initializes a new instance of the Nullable<T> structure to the specified value.

Proprietà

HasValue HasValue HasValue HasValue

Ottiene un valore che indica se l'oggetto Nullable<T> corrente presenta un valore valido per il proprio tipo sottostante.Gets a value indicating whether the current Nullable<T> object has a valid value of its underlying type.

Value Value Value Value

Ottiene il valore dell'oggetto corrente Nullable<T> se allo stesso oggetto è stato assegnato un valore sottostante valido.Gets the value of the current Nullable<T> object if it has been assigned a valid underlying value.

Metodi

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

Indica se l'oggetto Nullable<T> corrente è uguale a un oggetto specificato.Indicates whether the current Nullable<T> object is equal to a specified object.

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

Recupera il codice hash dell'oggetto restituito dalla proprietà Value.Retrieves the hash code of the object returned by the Value property.

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

Recupera il valore dell'oggetto Nullable<T> corrente o il valore predefinito del tipo sottostante.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)

Recupera il valore dell'oggetto Nullable<T> corrente o il valore predefinito specificato.Retrieves the value of the current Nullable<T> object, or the specified default value.

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

Restituisce la rappresentazione testo del valore dell'oggetto Nullable<T> corrente.Returns the text representation of the value of the current Nullable<T> object.

Operatori

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

Definisce una conversione esplicita di un'istanza Nullable<T> nel valore sottostante.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>)

Crea un nuovo oggetto Nullable<T> inizializzato su un valore specificato.Creates a new Nullable<T> object initialized to a specified value.

Si applica a

Vedi anche