{"title":"File.Erase(Text) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/file/file-erase-method/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/file/file-erase-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/file/file-erase-method","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Deletes a file.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":1,"title":"File.Erase(Text) Method","slug":"fileerasetext-method","at":0,"chars":1469},{"level":2,"title":"Syntax","slug":"syntax","at":174,"chars":128},{"level":2,"title":"Parameters","slug":"parameters","at":302,"chars":432},{"level":2,"title":"Return Value","slug":"return-value","at":734,"chars":387},{"level":2,"title":"Example","slug":"example","at":1121,"chars":216},{"level":2,"title":"Related information","slug":"related-information","at":1337,"chars":132}],"text":"# File.Erase(Text) Method\n> Version: _Available or changed with runtime version 1.0._\nDeletes a file.\n> NOTE\n> This method is supported only in Business Central on-premises.\n## Syntax\n```al\n[Ok := ]  File.Erase(Name: Text)\n```\n> NOTE\n> This method can be invoked without specifying the data type name.\n## Parameters\nName\nType: ../text/text-data-type\nThe name of the file that you want to delete, including the path. When you enter the path, consider these shortcuts:\n You can omit the drive designation if the file is located on the current drive.\n You can omit the full path if the file is located in the current directory.\n You can enter only the subdirectory name if the file is located in a subdirectory of the current directory.\n## Return Value\n*[Optional] Ok*\nType: ../boolean/boolean-data-type\ntrue if the operation was successful; otherwise false. If you omit this optional return value and the operation does not execute successfully, a runtime error will occur.\nIf the user who runs this method does not have the required permission to delete the file or if the file is read-only, then the file is not deleted.\n## Example\nThe following example deletes the file that is named C:\\\\TestFolder\\\\NewTestFile.txt.This example assumes that you have created the file on your computer.\n```al\nErase('C:\\TestFolder\\NewTestFile.txt');\n```\n## Related information\nfile-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}