DriveInfo.VolumeLabel Właściwość

Definicja

Przestrzeń nazw:

System.IO

Zestaw:

System.IO.FileSystem.DriveInfo.dll

Źródło:

DriveInfo.UnixOrDefault.cs

Pobiera lub ustawia etykietę woluminu dysku.

public:
 property System::String ^ VolumeLabel { System::String ^ get(); void set(System::String ^ value); };

public string VolumeLabel { get; [System.Runtime.Versioning.SupportedOSPlatform("windows")] set; }

[<set: System.Runtime.Versioning.SupportedOSPlatform("windows")>]
member this.VolumeLabel : string with get, set

Public Property VolumeLabel As String

Wartość właściwości

String

Etykieta woluminu.

Atrybuty

SupportedOSPlatformAttribute

Wyjątki

IOException

Wystąpił błąd we/wy (na przykład błąd dysku lub dysk nie był gotowy).

DriveNotFoundException

Dysk nie jest zamapowany lub nie istnieje.

SecurityException

Obiekt wywołujący nie posiada wymaganych uprawnień.

UnauthorizedAccessException

Etykieta woluminu jest ustawiana na dysku sieciowym lub CD-ROM.

-lub-

Odmowa dostępu do informacji o dysku.

Przykłady

W poniższym przykładzie pokazano użycie DriveInfo klasy do wyświetlania informacji o wszystkich dyskach w bieżącym systemie.

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);
                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:\
  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.
*/

Imports System.IO

Class Test
    Public Shared Sub Main()
        Dim allDrives() As DriveInfo = DriveInfo.GetDrives()

        Dim d As DriveInfo
        For Each d In allDrives
            Console.WriteLine("Drive {0}", d.Name)
            Console.WriteLine("  Drive type: {0}", d.DriveType)
            If d.IsReady = True Then
                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)
            End If
        Next
    End Sub
End Class
'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.

Uwagi

Długość etykiety jest określana przez system operacyjny. Na przykład system PLIKÓW NTFS umożliwia, aby etykieta woluminu składała się z maksymalnie 32 znaków. Należy pamiętać, że null jest to prawidłowy VolumeLabelelement .