DriveInfo.VolumeLabel Propriedade

Referência

Definição

Namespace:: System.IO

Assembly:: System.IO.FileSystem.DriveInfo.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Origem:: DriveInfo.UnixOrDefault.cs

Origem:: DriveInfo.UnixOrDefault.cs

Origem:: DriveInfo.UnixOrDefault.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define o rótulo do volume de uma unidade.

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

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

public string VolumeLabel { get; set; }

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

member this.VolumeLabel : string with get, set

Public Property VolumeLabel As String

Valor da propriedade

String

Rótulo do volume.

Atributos: SupportedOSPlatformAttribute

Exceções

IOException

Ocorreu um erro de E/S (por exemplo, um erro de disco ou uma unidade não estava pronta).

DriveNotFoundException

A unidade não está mapeada ou não existe.

SecurityException

O chamador não tem a permissão necessária.

UnauthorizedAccessException

O rótulo do volume está sendo definido em uma rede ou a unidade de CD-ROM.

- ou -

O acesso a informações da unidade é negado.

Exemplos

O exemplo a seguir demonstra o uso da DriveInfo classe para exibir informações sobre todas as unidades no sistema atual.

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.

Comentários

O comprimento do rótulo é determinado pelo sistema operacional. Por exemplo, o NTFS permite que um rótulo de volume tenha até 32 caracteres. Observe que null é um válido VolumeLabel.

Aplica-se a

Compartilhar via