Comando
WaitFile()
Pausa a execução do script até que o arquivo especificado exista no disco e não esteja bloqueado (locked) por outro processo. Suporta wildcard para aguardar qualquer arquivo correspondente ao padrão.
WaitFile(caminho [, timeout])Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
caminho | Sim | Caminho completo do arquivo a aguardar. Aceita wildcard *. Ex: @'C:\saida\*.xlsx'. |
timeout | Não | Tempo máximo de espera em segundos. Se omitido ou 0, aguarda até 24 horas. Lança exceção se o timeout for atingido sem o arquivo aparecer. |
Exemplos
// Aguardar arquivo por até 5 minutos:
WaitFile(@'C:\saida\relatorio.xlsx', 300)
// Aguardar qualquer .pdf por até 2 minutos:
WaitFile(@'C:\downloads\*.pdf', 120)Observações
Além de verificar a existência do arquivo, também verifica se ele não está bloqueado (locked) por outro processo — útil quando outro sistema ainda está gravando o arquivo.