Método My.Computer.FileSystem.GetFileInfo

Retorna um objeto FileInfo para o arquivo especificado.

' Usage
Dim value As System.IO.FileInfo = My.Computer.FileSystem.GetFileInfo(file)
' Declaration
Public Function GetFileInfo( _
   ByVal file As String _
) As System.IO.FileInfo

Parâmetros

• file
  String.Nome e caminho do arquivo.Obrigatório.

Valor de retorno

FileInfo

Exceções

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

• O nome do caminho é incorreto.Por exemplo, ele contém caracteres inválidos ou apenas espaços em branco (ArgumentException).

• O nome do arquivo possui uma barra (ArgumentException).

• O arquivo não existe ou é Nothing (ArgumentNullException).

• O caminho contém dois-pontos no meio da sequência de caracteres (NotSupportedException).

• O caminho é muito longo (PathTooLongException).

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

• O usuário não possui acesso ao arquivo por ACL (lista de controle de acesso) (UnauthorizedAccessException) .

Comentários

Uma exceção não é lançada se o arquivo não existir; em vez disso, ela será lançada quando as propriedades do objeto forem acessadas pela primeira vez.

Tarefas

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

Para	Consulte
Para obter informações sobre um arquivo	Como: Obter informações sobre um arquivo no Visual Basic
Para determinar o nome e caminho de um arquivo	Como: Analisar Arquivo Paths in Visual Basic

Exemplo

Este exemplo retorna um objeto System.IO.FileInfo para o arquivo MyLogFile.log e o utiliza para reportar o nome completo do arquivo, a hora do último acesso e o comprimento.

Dim information As System.IO.FileInfo
information = My.Computer.FileSystem.GetFileInfo("C:\MyLogFile.log")
MsgBox("The file's full name is " & information.FullName & ".")
MsgBox("Last access time is " & information.LastAccessTime & ".")
MsgBox("The length is " & information.Length & ".")

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

Tarefas

Demonstra Passo a passo: Manipular arquivos e pastas no Visual Basic

Referência

Objeto My.Computer.FileSystem

System.IO.FileInfo

FileSystem.GetFileInfo

Outros recursos

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