DoCmd.DeleteObject method (Access)
The DeleteObject method carries out the DeleteObject action in Visual Basic.
Syntax
expression.DeleteObject (ObjectType, ObjectName)
expression A variable that represents a DoCmd object.
Parameters
| Name | Required/Optional | Data type | Description |
|---|---|---|---|
| ObjectType | Optional | AcObjectType | An AcObjectType constant that represents the type of object to delete. |
| ObjectName | Optional | Variant | A string expression that's the valid name of an object of the type selected by the ObjectType argument. If you run Visual Basic code containing the DeleteObject method in a library database, Microsoft Access looks for the object with this name first in the library database, and then in the current database. |
Remarks
Use the DeleteObject method to delete a specified database object.
If you leave the ObjectType and ObjectName arguments blank (the default constant, acDefault, is assumed for ObjectType), Access deletes the object selected in the Database window. To select an object in the Database window, you can use the SelectObject action or SelectObject method with the InDatabaseWindow argument set to Yes (True).
Example
The following example deletes the specified table.
DoCmd.DeleteObject acTable, "Former Employees Table"
Support and feedback
Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for