DriveInfo.VolumeLabel DriveInfo.VolumeLabel DriveInfo.VolumeLabel DriveInfo.VolumeLabel Property

Definition

Ruft die Volumebezeichnung eines Laufwerks ab oder legt diese fest.Gets or sets the volume label of a drive.

public:
 property System::String ^ VolumeLabel { System::String ^ get(); void set(System::String ^ value); };
public string VolumeLabel { get; set; }
member this.VolumeLabel : string with get, set
Public Property VolumeLabel As String

Eigenschaftswert

Die Volumebezeichnung.The volume label.

Ausnahmen

E/A-Fehler (z. B. ein Datenträgerfehler, oder ein Laufwerk war nicht bereit).An I/O error occurred (for example, a disk error or a drive was not ready).

Das Laufwerk ist nicht zugeordnet oder nicht vorhanden.The drive is not mapped or does not exist.

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Die Volumebezeichnung wird für ein Netzwerk- oder CD-ROM-Laufwerk festgelegt.The volume label is being set on a network or CD-ROM drive.

- oder --or- Zugriff auf Laufwerksinformationen wird verweigert.Access to the drive information is denied.

Beispiele

Das folgende Beispiel zeigt die Verwendung der DriveInfo zum Anzeigen von Informationen über alle Laufwerke auf dem aktuellen System.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);
                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
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.

Hinweise

Die Bezeichnungslänge wird vom Betriebssystem bestimmt.The label length is determined by the operating system. NTFS ermöglicht z. B. eine Volumebezeichnung bis zu 32 Zeichen lang sein.For example, NTFS allows a volume label to be up to 32 characters long. Beachten Sie, dass null ist ein gültiger VolumeLabel.Note that null is a valid VolumeLabel.

Sicherheit

FileIOPermission
zum Festlegen der Volumebezeichnung an.for setting the volume label. Zugeordnete Enumeration: WriteAssociated enumeration: Write.

Gilt für: