Nullable<T> Struktura

Definice

Představuje typ hodnoty, který lze přiřadit null.

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

Parametry typu

T

Typ základní hodnoty Nullable<T> obecného typu.

Dědičnost
Nullable<T>
Atributy

Příklady

Následující příklad kódu definuje tři řádky tabulky v ukázkové databázi Microsoft Pubs. Tabulka obsahuje dva sloupce, které nemají hodnotu null, a dva sloupce s možnou hodnotou null.

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.

Poznámky

Další informace o tomto rozhraní API najdete v tématu Doplňkové poznámky k rozhraní API pro T s možnou<> hodnotou null.

Konstruktory

Nullable<T>(T)

Inicializuje novou instanci Nullable<T> struktury na zadanou hodnotu.

Vlastnosti

HasValue

Získá hodnotu označující, zda aktuální Nullable<T> objekt má platnou hodnotu svého základního typu.

Value

Získá hodnotu aktuálního Nullable<T> objektu, pokud byla přiřazena platná podkladová hodnota.

Metody

Equals(Object)

Určuje, zda je aktuální Nullable<T> objekt roven zadanému objektu.

GetHashCode()

Načte kód hash objektu vráceného Value vlastností.

GetValueOrDefault()

Načte hodnotu aktuálního Nullable<T> objektu nebo výchozí hodnotu základního typu.

GetValueOrDefault(T)

Načte hodnotu aktuálního Nullable<T> objektu nebo zadanou výchozí hodnotu.

ToString()

Vrátí text reprezentaci hodnoty aktuálního Nullable<T> objektu.

Operátory

Explicit(Nullable<T> to T)

Definuje explicitní převod Nullable<T> instance na její podkladovou hodnotu.

Implicit(T to Nullable<T>)

Vytvoří nový Nullable<T> objekt inicializovaný na zadanou hodnotu.

Platí pro

Produkt Verze
.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
.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

Viz také