DeleteObject Action

Description

You can use the DeleteObject action within a macro to delete a specified database object.

Setting

The DeleteObject action uses the following arguments.

Action argument Description
Object Type The type of object to delete. Click Table, Query, Form, Report, Macro, or Module in the Object Type box in the Action Arguments section of the Macro window. To delete the object selected in the Database window, leave this box blank.


Action argument Description
Object Name The name of the object to delete. The Object Name box shows all objects in the database of the type selected by the Object Type argument. If you left the Object Type box blank, leave this box blank also.
If you run a macro containing the DeleteObject action in a library database, Microsoft Access will look for the object with this name first in the library database, then in the current database.


Warning If you leave the Object Type and Object Name arguments blank, Microsoft Access will delete the object selected in the Database window without displaying a warning message when it encounters the DeleteObject action. To select an object in the Database window, you can use the SelectObject action with the In Database Window argument set to Yes.

Remarks

You can use the DeleteObject action to delete temporary objects you’ve created while running the macro. For example, you could use the OpenQuery action to run a make-table query that creates a temporary table. When you’re finished using the temporary table, you can use the DeleteObject action to delete it.

This action has the same effect as selecting an object in the Database window and then pressing the DEL key or clicking Delete on the Edit menu. When you use the DeleteObject action, you don’t need to select the object in the Database window, and Microsoft Access doesn’t display a dialog box asking you to confirm the deletion.

To run the DeleteObject action in Visual Basic, you can use the DeleteObject method of the DoCmd object.

See Also

DeleteObject Method, SelectObject Action.