Skip to main content
NullableToString Method
 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Returns the text representation of the value of the current Nullable object.

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

public override string ToString()
public:
virtual String^ ToString() override
override ToString : unit -> string
Public Overrides Function ToString As String

Return Value

Type:

The text representation of the value of the current Nullable object if the property is true, or an empty string ("") if the property is false.

The ToString property returns the string yielded by calling the ToString property of the object returned by the property.

The following code example displays the value of the current Nullable object.

// This code example demonstrates the 
// Nullable<T>.ToString method.

using System;

class Sample 
{
    public static void Main() 
    {
    DateTime? nullableDate;

// Display the current date and time.
    nullableDate = DateTime.Now;
    Display("1)", nullableDate);

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

// Display the text representation of a nullable DateTime.
    public static void Display(string title, DateTime? dspDT)
    {
    string msg = dspDT.ToString();

    Console.Write("{0} ", title);
    if (String.IsNullOrEmpty(msg))
        Console.WriteLine("The nullable DateTime has no defined value.");
    else
        Console.WriteLine("The current date and time is {0}.", msg);
    }
}

/*
This code example produces the following results:

1) The current date and time is 4/19/2005 8:28:14 PM.
2) The nullable DateTime has no defined value.

*/
' This code example demonstrates the 
' Nullable<T>.ToString method.

Imports System

Class Sample
    Public Shared Sub Main() 
        Dim nullableDate As Nullable(Of DateTime)
    ' Display the current date and time.
        nullableDate = DateTime.Now
        Display("1)", nullableDate)

    ' Assign null (Nothing in Visual Basic) to nullableDate, then 
    ' display its value.
        nullableDate = Nothing
        Display("2)", nullableDate)
    End Sub 'Main

    '  Display the text representation of a nullable DateTime.
    Public Shared Sub Display(ByVal title As String, _
                              ByVal dspDT As Nullable(Of DateTime))
        Dim msg As String = dspDT.ToString()

        Console.Write("{0} ", title)
        If String.IsNullOrEmpty(msg) Then
            Console.WriteLine("The nullable DateTime has no defined value.")
        Else
            Console.WriteLine("The current date and time is {0}.", msg)
        End If
    End Sub 'Display 
End Class 'Sample

'This code example produces the following results:
'
'1) The current date and time is 4/19/2005 8:28:14 PM.
'2) The nullable DateTime has no defined value.
'
Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top