Nullable<T> Struktur

Definisi

generic <typename T>
 where T : value classpublic value class Nullable

public struct Nullable<T> where T : struct

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

type Nullable<'T (requires 'T : struct)> = struct

[<System.Serializable>]
type Nullable<'T (requires 'T : struct)> = struct

Public Structure Nullable(Of T)

Jenis parameter

Warisan

Object

ValueType

Nullable<T>

Atribut

SerializableAttribute

Contoh

Contoh kode berikut mendefinisikan tiga baris tabel dalam database sampel Microsoft Pubs. Tabel berisi dua kolom yang tidak dapat diubah ke null dan dua kolom yang dapat diubah ke 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.

open System

// Define the "titleAuthor" table of the Microsoft "pubs" database.

type titleAuthor =
  struct
    // Author ID format ###-##-####
    val mutable au_id: string
    // Title ID format AA####
    val mutable title_id: string
    // Author ORD is nullable.
    val mutable au_ord: Nullable<int16>
    // Royalty Percent is nullable.
    val mutable royaltyper: Nullable<int>
  end

// Display the values of the titleAuthor array elements.
let display dspTitle (dspAllTitleAuthors: #seq<titleAuthor>) =
    printfn $"*** {dspTitle} ***"
    for dspTA in dspAllTitleAuthors do
        printfn $"Author ID ... {dspTA.au_id}"
        printfn $"Title ID .... {dspTA.title_id}"
        printfn $"Author ORD .. {dspTA.au_ord.GetValueOrDefault -1s}"
        printfn $"Royalty %% ... {dspTA.royaltyper.GetValueOrDefault -1}\n"

// Declare and initialize the titleAuthor array.
let ta = Array.zeroCreate<titleAuthor> 3
ta[0].au_id <- "712-32-1176"
ta[0].title_id <- "PS3333"
ta[0].au_ord <- Nullable 1s
ta[0].royaltyper <- Nullable 100

ta[1].au_id <- "213-46-8915"
ta[1].title_id <- "BU1032"
ta[1].au_ord <- Nullable()
ta[1].royaltyper <- Nullable()

ta[2].au_id <- "672-71-3249"
ta[2].title_id <- "TC7777"
ta[2].au_ord <- Nullable()
ta[2].royaltyper <- Nullable 40

// Display the values of the titleAuthor array elements, and
// display a legend.
display "Title Authors Table" ta
printfn "Legend:"
printfn "An Author ORD of -1 means no value is defined."
printfn "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.

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.

Keterangan

Kelas Nullable mewakili jenis nilai yang dapat ditetapkan null.

Jenis dikatakan dapat diubah ke null jika dapat diberi nilai atau dapat ditetapkan null, yang berarti jenis tidak memiliki nilai apa pun. Secara default, semua jenis referensi, seperti String, dapat diubah ke null, tetapi semua jenis nilai, seperti Int32, tidak.

Di C# dan Visual Basic, Anda menandai jenis nilai sebagai nullable dengan menggunakan ? notasi setelah jenis nilai. Misalnya, int? di C# atau Integer? di Visual Basic mendeklarasikan jenis nilai bilangan bulat yang dapat ditetapkan null.

Struktur Nullable<T> hanya mendukung penggunaan jenis nilai sebagai jenis nullable karena jenis referensi sudah nullable menurut desain.

Kelas Nullable ini menyediakan dukungan pelengkap untuk struktur Nullable<T>. Kelas Nullable mendukung perolehan jenis dasar dari jenis nullable, serta operasi perbandingan dan kesetaraan pada pasangan jenis nullable yang nilai dasarnya tidak mendukung operasi perbandingan dan kesetaraan generik.

Properti dasar

Dua anggota mendasar dari struktur Nullable<T> adalah properti HasValue dan Value. HasValue Jika properti untuk Nullable<T> objek adalah true, nilai objek dapat diakses dengan Value properti . HasValue Jika properti adalah false, nilai objek tidak terdefinisi dan upaya untuk mengakses Value properti melemparkan InvalidOperationException.

Boxing dan Unboxing

Ketika tipe nullable dikotakkan, runtime bahasa umum secara otomatis mengotakkan nilai dasar dari objek Nullable<T>, bukan objek Nullable<T> itu sendiri. Artinya, jika properti HasValue adalah true, konten dari properti Value dikotak. Ketika nilai yang mendasari jenis nullable dibuka kotaknya, common language runtime membuat struktur baru Nullable<T> yang diinisialisasi ke nilai yang mendasarinya.

HasValue Jika properti dari jenis nullable adalah false, hasil dari operasi tinju adalah null. Akibatnya, jika jenis nullable yang dibungkus diteruskan ke metode yang mengharapkan argumen objek, metode tersebut harus siap menangani kasus di mana argumennya adalah null. Ketika null dibuka ke dalam jenis nullable, runtime bahasa umum membuat struktur baru Nullable<T> dan menginisialisasi propertinya HasValue ke false.

Komponen runtime Windows

Anda dapat menyertakan jenis Nullable<T> sebagai anggota dari struktur yang diekspor di pustaka WinMD.

Lihat juga

• Nullable
• Tipe Yang Dapat Diubah Ke null (Panduan Pemrograman C#)
• Jenis Nilai Yang Dapat Diubah Ke null (Visual Basic)