folder.delete( )

4D v19

folder.delete( )

Descrição

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).

Ver também

DELETE DOCUMENT
DELETE FOLDER