DriveInfo.VolumeLabel Property
[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]
Updated: July 2010
Gets or sets the volume label of a drive.
Namespace: System.IO
Assembly: mscorlib (in mscorlib.dll)
| Exception | Condition |
|---|---|
| IOException |
An I/O error occurred (for example, a disk error or a drive was not ready). |
| DriveNotFoundException |
The drive is not mapped or does not exist. |
| SecurityException |
The caller does not have the required permission. |
| UnauthorizedAccessException |
The volume label is being set on a network or CD-ROM drive. -or- Access to the drive information is denied. |
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(" File type: {0}", d.DriveType); if (d.IsReady == true) { Console.WriteLine(" Volume label: {0}", d.VolumeLabel); Console.WriteLine(" File system: {0}", d.DriveFormat); Console.WriteLine( " Available space to current user:{0, 15} bytes", d.AvailableFreeSpace); Console.WriteLine( " Total available space: {0, 15} bytes", d.TotalFreeSpace); Console.WriteLine( " Total size of drive: {0, 15} bytes ", d.TotalSize); } } } } /* This code produces output similar to the following: Drive A:\ File type: Removable Drive C:\ File 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:\ File 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:\ File type: CDRom The actual output of this code will vary based on machine and the permissions granted to the user executing it. */
-
FileIOPermission
for setting the volume label. Associated enumeration: Write.
Windows 8 Consumer Preview, Windows Server 8 Beta, Windows 7, Windows Server 2008 SP2, 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.
