Skip to main content
.NET Framework Class Library
NullableTToString Method

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

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)
Syntax
Public Overrides Function ToString As [%$TOPIC/9hd15ket_en-us_VS_110_2_0_0_0_0%]
public override [%$TOPIC/9hd15ket_en-us_VS_110_2_0_1_0_0%] ToString()
public:
virtual [%$TOPIC/9hd15ket_en-us_VS_110_2_0_2_0_0%]^ ToString() override
abstract ToString : unit -> [%$TOPIC/9hd15ket_en-us_VS_110_2_0_3_0_0%]  
override ToString : unit -> [%$TOPIC/9hd15ket_en-us_VS_110_2_0_3_0_1%]

Return Value

Type: SystemString
The text representation of the value of the current NullableT object if the HasValue property is true, or an empty string ("") if the HasValue property is false.
Remarks

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

Examples

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

' 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. 
'
// 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.

*/
Version Information

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Platforms

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.