Função FreeFile

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 número inteiro que representa o número de ficheiro seguinte disponível para utilização pela instrução Open .

Sintaxe

FreeFile[(intervalo)]

O argumento opcional rangenumber é uma Variante que especifica o intervalo a partir do qual o próximo número de ficheiro gratuito deve ser devolvido. Especifique um 0 (predefinição) para devolver um número de ficheiro no intervalo 1 – 255, inclusive. Especifique um 1 para devolver um número de ficheiro no intervalo 256 – 511.

Observações

Use o FreeFile para fornecer um número de arquivo que ainda não esteja em uso.

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 FreeFile para retornar o próximo número de arquivo disponível. Cinco arquivos são abertos para saída dentro do loop, e alguns dados de exemplo são gravados em cada um.

Dim MyIndex, FileNumber
For MyIndex = 1 To 5    ' Loop 5 times.
    ' Get unused file number.
    FileNumber = FreeFile
    ' Create file name.
    Open "TEST" & MyIndex For Output As #FileNumber
    ' Output text.
    Write #FileNumber, "This is a sample."
    ' Close file.
    Close #FileNumber
Next MyIndex