Função FileLen

Aplica-se A
Access para Microsoft 365 Access 2021 Access 2019 Access 2016

Nota

A função, método, objeto ou propriedade descrita neste tópico será desativada se o Serviço Microsoft Jet Expression estiver em execução no modo sandbox, o que impede a avaliação de expressões potencialmente não seguras. Para obter mais informações sobre o modo sandbox, pesquise "modo sandbox" na Ajuda.

Devolve um Long especificando o comprimento de um ficheiro em bytes.

Sintaxe

FileLen(nomedocaminho)

O argumento nome do caminhonecessário é uma expressão de cadeia de caracteres que especifica um arquivo. O nome do caminho pode incluir o diretório ou pasta e a unidade.

Observações

Se o arquivo especificado estiver aberto quando a função FileLen for chamada, o valor retornado representará o tamanho do arquivo imediatamente antes de ser aberto.

Nota

Para obter o comprimento de um ficheiro aberto, utilize a função LOF .

Exemplo

Nota

Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre como trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo usa a função FileLen para retornar o comprimento de um arquivo em bytes. Para efeitos deste exemplo, assumamos que se trata de um ficheiro que TESTFILE contém alguns dados.

Dim MySize
MySize = FileLen("TESTFILE") ' Returns file length (bytes).