O método folder.delete( ) elimina a pasta.
De maneira predeterminada, por razões de segurança, se omite o parâmetro opção, folder.delete( ) só permite que sejam eliminadas as pastas vazias. Se quiser que o comando possa eliminar pastas que não estejam vazias, deve utilizar o parâmetro opção com uma das seguintes constantes:
Constante |
Valor |
Comentário |
Delete only if empty |
0 |
Apaga a pasta apenas se a pasta estiver vazia. |
Delete with contents |
1 |
Apaga a pasta com todos os seus conteúdos |
Quando se passar Delete only if empty ou se omitir o parâmetro opção:
- a pasta só é apagada se estiver vazia, do contrário, o comando não faz nada e é gerado um erro -47.
- Se a pasta não existir, se gera o erro -120.
Quando passar Delete with contents:
- a pasta, junto com todos seus conteúdos, se apaga.
Advertência: mesmo quando esta carpeta ou seu conteúdo estiverem bloqueados ou configurados em apenas leitura, se o usuário atual tiver os direitos de acesso adequados, a pasta (e o conteúdo) ainda são eliminadas. - Se esta pasta, ou qualquer dos arquivos que conter, não puder ser eliminada, a eliminação se cancela logo que se detectar o primeiro elemento inacessível e se devolver um erro (*).Neste caso, a pasta só pode ser eliminada parcialmente. Quando se cancelar a eliminação, pode utilizar o comando GET LAST ERROR STACK para recuperar o nome e a rota do arquivo concernente.
- Se a pásta não existir, o comando não faz nada e não se devolve nenhum erro.
(*) Windows: -54 (tenta abrir o arquivo bloqueado para escrever)
macOS: -45 (o arquivo está bloqueado ou a rota de acesso não é correta).