Compartilhar via


Método My.Computer.FileSystem.GetDriveInfo

Retorna um objeto DriveInfo para a unidade 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.Unidade a ser examinado.Obrigatório.

Valor de retorno

DriveInfo

Exceções

As seguintes condições podem causar uma exceção:

  • O caminho inválido para um dos seguintes motivos: Ele é uma cadeia de comprimento zero; ele contém somente espaços em branco; ele contém caracteres inválidos; ou é um caminho de dispositivo (começa com \\.\) (ArgumentException).

  • O caminho não é válido porque ele é Nothing (ArgumentNullException).

  • O caminho excede o comprimento máximo definido pelo sistema (PathTooLongException).

  • Um arquivo ou nome da pasta no caminho contém dois-pontos (:) ou está em formato inválido (NotSupportedException).

  • O usuário não possui permissões necessárias para exibir o caminho (SecurityException).

Comentários

A classe DriveInfo modela uma unidade e fornece métodos e propriedades para consultar informações sobre a unidade.Use DriveInfo para determinar quais unidades estão disponíveis, e o tipo de unidades que elas são.Você também pode consultar a propriedade para determinar a capacidade e espaço livre disponível na unidade.

Tarefas

A tabela a seguir lista exemplos de tarefas envolvendo o método My.Computer.FileSystem.GetDriveInfo.

Para

Consulte

Determinar um rótulo de volume da unidade

Como: Determinar o rótulo do volume de uma unidade no Visual Basic

Determinar uma unidade do tipo

Como: Determinar o tipo de uma unidade no Visual Basic

Determinar um espaço total da unidade

Como: Determinar o espaço total de uma unidade no Visual Basic

Determinar um espaço físico livre da unidade

Como: Determinar física espaço livre uma unidade no Visual Basic

Determinar uma pasta raiz da unidade

Como: Determinar o diretório raiz de uma unidade no Visual Basic

Exemplo

Este exemplo obtém um objeto DriveInfo para a unidade C e usa-o para exibir informações sobre a unidade.

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 obter informações sobre os tipos de unidade diferente, consulte DriveType.

Requisitos

Namespace:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornece acesso a FileSystem)

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto

Disponível

Aplicativo do Windows

Sim

Biblioteca de Classe

Sim

Aplicativo de Console

Sim

Biblioteca de Controle do Windows

Sim

Biblioteca de Controle da Web

Sim

Serviço do Windows

Sim

Site

Sim

Permissões

A permissão a seguir pode ser necessária:

Permissão

Descrição

FileIOPermission

Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted.

Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.

Consulte também

Referência

Objeto My.Computer.FileSystem

System.IO.DriveInfo

GetDriveInfo

DriveType

Outros recursos

Propriedades de arquivo, diretório e unidade no Visual Basic