The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Nullable<T>.Value Property

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Gets the value of the current Nullable<T> value.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public T Value { get; }

Property Value

Type: T
The value of the current Nullable<T> object if the HasValue property is true. An exception is thrown if the HasValue property is false.


The HasValue property is false.

The following code example returns the value of a Nullable<T> object if that object has a defined value; otherwise, a default value is returned.

// This code example demonstrates the Nullable<T>.HasValue 
// and Value properties.

using System;

class Example
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
      DateTime? myNow;

      //  Assign the current date and time to myNow then display its value.
      myNow = DateTime.Now;
      Display(outputBlock, myNow, "1) ");

      //  Assign null (Nothing in Visual Basic) to myNow then display its value.
      myNow = null;
      Display(outputBlock, myNow, "2) ");

   // Display the date and time.
   public static void Display(System.Windows.Controls.TextBlock outputBlock, DateTime? displayDateTime, string title)
      // If a value is defined for the displayDatetime argument, display its value; otherwise, 
      // display that no value is defined.
      outputBlock.Text += title;
      if (displayDateTime.HasValue == true)
         outputBlock.Text += String.Format("The date and time is {0:F}.", displayDateTime.Value) + "\n";
         outputBlock.Text += "The date and time is not defined." + "\n";

This code example produces the following results:

1) The date and time is Tuesday, April 19, 2005 4:16:06 PM.
2) The date and time is not defined.


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone