My.Computer.FileSystem.GetDriveInfo, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Retourne un objet DriveInfo pour le lecteur spécifié.

' Usage
Dim value As System.IO.DriveInfo = My.Computer.FileSystem.GetDriveInfo(drive)
' Declaration
Public Function GetDriveInfo( _
   ByVal drive As String _
) As System.IO.DriveInfo

Paramètres

drive
String. Lecteur à examiner. Obligatoire.

Valeur de retour

DriveInfo

Exceptions

Les conditions ci-dessous peuvent générer une exception :

Le chemin d'accès n'est pas valide pour une des raisons suivantes : il s'agit d'une chaîne de longueur nulle ; il ne contient que des espaces blancs ; il contient des caractères non valides ou il s'agit d'un chemin d'accès de périphérique (qui commence par \\.\) (ArgumentException).
Le chemin d'accès n'est pas valide, car il a la valeur Nothing (ArgumentNullException).
Le chemin d'accès dépasse la longueur maximale définie par le système (PathTooLongException).
Un nom de fichier ou de dossier du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct (NotSupportedException).
L'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès (SecurityException).

Notes

La classe DriveInfo modèle un lecteur et fournit des méthodes et des propriétés pour demander des informations sur le lecteur. Utilisez DriveInfo pour déterminer les lecteurs disponibles et leur type. Vous pouvez également interroger la propriété pour déterminer la capacité et l'espace libre disponible sur le lecteur.

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant la méthode My.Computer.FileSystem.GetDriveInfo.

Pour	Consultez
Déterminer le nom de volume d'un lecteur	Comment : déterminer le nom de volume d'un lecteur dans Visual Basic
Déterminer le type d'un lecteur	Comment : déterminer le type d'un lecteur dans Visual Basic
Déterminer l'espace total d'un lecteur	Comment : déterminer l'espace total d'un lecteur dans Visual Basic
Déterminer l'espace physique libre d'un lecteur	Comment : déterminer l'espace physique disponible sur un lecteur dans Visual Basic
Déterminer le dossier racine d'un lecteur	Comment : déterminer le répertoire racine d'un lecteur dans Visual Basic

Exemple

Cet exemple obtient un objet DriveInfo pour le lecteur C et l'utilise pour afficher des informations sur le lecteur.

Dim getInfo As System.IO.DriveInfo
getInfo = My.Computer.FileSystem.GetDriveInfo("C:\")
MsgBox("The drive's type is " & getInfo.DriveType)
MsgBox("The drive has " & getInfo.TotalFreeSpace & " bytes free.")

Pour plus d'informations sur les différents types de lecteur, consultez DriveType.

Configuration requise

Espace de noms :Microsoft.VisualBasic.MyServices

Classe :FileSystemProxy (fournit l'accès à FileSystem)

Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Oui
Application console	Oui
Bibliothèque de contrôles Windows	Oui
Bibliothèque de contrôles Web	Oui
Service Windows	Oui
Site Web	Oui