Nullable<T> 구조체

정의

null에 할당할 수 있는 값 형식을 나타냅니다.Represents a value type that can be assigned null.

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
Public Structure Nullable(Of T)

형식 매개 변수

T

Nullable<T> 제네릭 형식의 내부 값 형식입니다.The underlying value type of the Nullable<T> generic type.

상속
Nullable<T>
특성

예제

다음 코드 예제에서는 Microsoft Pubs 예제 데이터베이스에서 테이블의 3 개의 행을 정의합니다.The following code example defines three rows of a table in the Microsoft Pubs sample database. Null을 허용 하지 않은 두 개의 열과 두 개의 열이 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.

설명

형식이 값을 할당할 수 있거나 null할당 될 수 있는 경우 (형식에 값이 없음을 의미 함) nullable 이라고 합니다.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. 기본적으로 String와 같은 모든 참조 형식은 nullable 이지만 Int32와 같은 모든 값 형식은 사용할 수 없습니다.By default, all reference types, such as String, are nullable, but all value types, such as Int32, are not.

C# 및 Visual Basic 값 형식 뒤에 ? 표기법을 사용 하 여 값 형식을 nullable로 표시 합니다.In C# and Visual Basic, you mark a value type as nullable by using the ? notation after the value type. 예를 들어 Visual Basic의 C# int? 또는 Integer?null할당할 수 있는 정수 값 형식을 선언 합니다.For example, int? in C# or Integer? in Visual Basic declares an integer value type that can be assigned null.

참조 형식이 의도적으로 null을 허용 하기 때문에 Nullable<T> 구조에서는 값 형식만 nullable 형식으로 사용 하도록 지원 합니다.The Nullable<T> structure supports using only a value type as a nullable type because reference types are nullable by design.

Nullable 클래스는 Nullable<T> 구조체를 보완 하도록 지원 합니다.The Nullable class provides complementary support for the Nullable<T> structure. Nullable 클래스는 nullable 형식의 기본 형식에 대 한 가져오기를 지원 하 고 내부 값 형식이 제네릭 비교 및 같음 연산을 지원 하지 않는 nullable 형식 쌍에 대 한 비교 및 같음 연산을 지원 합니다.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.

기본 속성Fundamental Properties

Nullable<T> 구조체의 두 가지 기본 멤버는 HasValueValue 속성입니다.The two fundamental members of the Nullable<T> structure are the HasValue and Value properties. Nullable<T> 개체의 HasValue 속성이 true되 면 Value 속성을 사용 하 여 개체의 값에 액세스할 수 있습니다.If the HasValue property for a Nullable<T> object is true, the value of the object can be accessed with the Value property. HasValue 속성이 false이면 개체의 값이 정의 되지 않고 Value 속성에 액세스 하려고 하면 InvalidOperationExceptionthrow 됩니다.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 및 unboxingBoxing and Unboxing

Nullable 형식이 boxing 되 면 공용 언어 런타임은 Nullable<T> 개체 자체가 아닌 Nullable<T> 개체의 내부 값을 자동으로 boxing 합니다.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. 즉, HasValue 속성이 true경우 Value 속성의 내용은 boxing 됩니다.That is, if the HasValue property is true, the contents of the Value property is boxed. Nullable 형식의 내부 값이 unboxing 되 면 공용 언어 런타임은 내부 값으로 초기화 된 새 Nullable<T> 구조체를 만듭니다.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.

Nullable 형식의 HasValue 속성이 false되는 경우 boxing 작업의 결과가 null됩니다.If the HasValue property of a nullable type is false, the result of a boxing operation is null. 따라서 개체 인수가 필요한 메서드에 boxed nullable 형식을 전달 하는 경우 해당 메서드는 인수가 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. null를 nullable 형식으로 unboxing 하는 경우 공용 언어 런타임은 새 Nullable<T> 구조체를 만들고 HasValue 속성을 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 및 Windows 런타임 구성 요소and Windows Runtime Components

.NET Framework 4.5.1.NET Framework 4.5.1부터 Nullable<T> 형식을 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. 이전에이 지원 되지 않았습니다.Previously, this was not supported.

생성자

Nullable<T>(T)

Nullable<T> 구조체의 새 인스턴스를 지정된 값으로 초기화합니다.Initializes a new instance of the Nullable<T> structure to the specified value.

속성

HasValue

현재 Nullable<T> 개체에 해당 내부 형식의 올바른 값이 있는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether the current Nullable<T> object has a valid value of its underlying type.

Value

올바른 내부 형식 값이 할당된 경우 현재 Nullable<T> 개체의 값을 가져옵니다.Gets the value of the current Nullable<T> object if it has been assigned a valid underlying value.

메서드

Equals(Object)

현재 Nullable<T> 개체가 지정된 개체와 같은지 여부를 나타냅니다.Indicates whether the current Nullable<T> object is equal to a specified object.

GetHashCode()

Value 속성에서 반환하는 개체의 해시 코드를 검색합니다.Retrieves the hash code of the object returned by the Value property.

GetValueOrDefault()

현재 Nullable<T> 개체의 값 또는 기본 유형의 기본값을 검색합니다.Retrieves the value of the current Nullable<T> object, or the default value of the underlying type.

GetValueOrDefault(T)

현재 Nullable<T> 개체의 값이나 지정된 기본값을 검색합니다.Retrieves the value of the current Nullable<T> object, or the specified default value.

ToString()

현재 Nullable<T> 개체 값의 텍스트 표현을 반환합니다.Returns the text representation of the value of the current Nullable<T> object.

연산자

Explicit(Nullable<T> to T)

Nullable<T> 인스턴스의 명시적 변환을 해당 내부 값으로 정의합니다.Defines an explicit conversion of a Nullable<T> instance to its underlying value.

Implicit(T to Nullable<T>)

지정된 값으로 초기화된 새 Nullable<T> 개체를 만듭니다.Creates a new Nullable<T> object initialized to a specified value.

적용 대상

추가 정보