VolumeLabel Property

DriveInfo.VolumeLabel Property


Gets or sets the volume label of a drive.

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

public string VolumeLabel { get; set; }

Property Value

Type: System.String

The volume label.

Exception Condition

An I/O error occurred (for example, a disk error or a drive was not ready).


The drive is not mapped or does not exist.


The caller does not have the required permission.


The volume label is being set on a network or CD-ROM drive.


Access to the drive information is denied.

The label length is determined by the operating system. For example, NTFS allows a volume label to be up to 32 characters long. Note that null is a valid VolumeLabel.

The following example demonstrates the use of the DriveInfo class to display information about all the drives on the current system.

using System;
using System.IO;

class Test
    public static void Main()
        DriveInfo[] allDrives = DriveInfo.GetDrives();

        foreach (DriveInfo d in allDrives)
            Console.WriteLine("Drive {0}", d.Name);
            Console.WriteLine("  Drive type: {0}", d.DriveType);
            if (d.IsReady == true)
                Console.WriteLine("  Volume label: {0}", d.VolumeLabel);
                Console.WriteLine("  File system: {0}", d.DriveFormat);
                    "  Available space to current user:{0, 15} bytes", 

                    "  Total available space:          {0, 15} bytes",

                    "  Total size of drive:            {0, 15} bytes ",
This code produces output similar to the following:

Drive A:\
  Drive type: Removable
Drive C:\
  Drive type: Fixed
  Volume label: 
  File system: FAT32
  Available space to current user:     4770430976 bytes
  Total available space:               4770430976 bytes
  Total size of drive:                10731683840 bytes 
Drive D:\
  Drive type: Fixed
  Volume label: 
  File system: NTFS
  Available space to current user:    15114977280 bytes
  Total available space:              15114977280 bytes
  Total size of drive:                25958948864 bytes 
Drive E:\
  Drive type: CDRom

The actual output of this code will vary based on machine and the permissions
granted to the user executing it.

for setting the volume label. Associated enumeration: Write.

.NET Framework
Available since 2.0
Return to top
© 2015 Microsoft