My.Computer.FileSystem.GetDriveInfo (Método)

Artículo
08/23/2008

Actualización: noviembre 2007

Devuelve un objeto DriveInfo para la unidad especificada.

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

Parámetros

drive
String. Archivo que se debe examinar. Obligatorio.

Valor devuelto

DriveInfo

Excepciones

Las condiciones siguientes pueden producir una excepción:

La ruta de acceso no es válida por una de las razones siguientes: es una cadena de longitud cero; sólo contiene un espacio en blanco; contiene caracteres no válidos; o es una ruta de acceso de dispositivo (empieza por \\.\) (ArgumentException).
La ruta de acceso no es válida porque es Nothing (ArgumentNullException).
La ruta supera la longitud máxima definida por el sistema (PathTooLongException).
Un nombre de archivo o de carpeta en la ruta de acceso contiene dos puntos (:) o está en un formato no válido (NotSupportedException).
El usuario no tiene los permisos necesarios para ver la ruta de acceso (SecurityException).

Comentarios

La clase DriveInfo modela una unidad y proporciona métodos y propiedades para consultar información de la unidad. Utilice DriveInfo para determinar qué unidades están disponibles y qué tipo de unidades son. También puede consultar la propiedad para determinar la capacidad de la unidad espacio libre disponible en ella.

Tareas

La tabla siguiente muestra una lista de ejemplos de tareas en las que está implicado el método My.Computer.FileSystem.GetDriveInfo.

Para	Vea
Determinar la etiqueta de volumen de una unidad	Cómo: Determinar la etiqueta de volumen de una unidad en Visual Basic
Determinar el tipo de una unidad	Cómo: Determinar el tipo de una unidad en Visual Basic
Determinar el espacio total de una unidad	Cómo: Determinar el espacio total de una unidad en Visual Basic
Determinar el espacio físico disponible en una unidad	Cómo: Determinar el espacio disponible de una unidad en Visual Basic
Determinar la carpeta raíz de una unidad	Cómo: Determinar el directorio raíz de una unidad en Visual Basic

Ejemplo

Este ejemplo obtiene un objeto DriveInfo para la unidad C y lo utiliza para mostrar información sobre ella.

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.")

Para obtener información sobre los distintos tipos de unidad, vea DriveType.

Requisitos

Espacio de nombres:Microsoft.VisualBasic.MyServices

Clase:FileSystemProxy (proporciona acceso a FileSystem)

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación para Windows	Sí
Biblioteca de clases	Sí
Aplicación de consola	Sí
Biblioteca de controles de Windows	Sí
Biblioteca de controles Web	Sí
Servicio de Windows	Sí
Sitio Web	Sí