DoCmd.OpenQuery method (Access)

The OpenQuery method carries out the OpenQuery action in Visual Basic.


expression.OpenQuery (QueryName, View, DataMode)

expression A variable that represents a DoCmd object.


Name Required/Optional Data type Description
QueryName Required Variant A string expression that's the valid name of a query in the current database. If you execute Visual Basic code containing the OpenQuery method in a library database, Microsoft Access looks for the query with this name first in the library database, and then in the current database.
View Optional AcView An AcView constant that specifies the view in which the query will open. The default value is acViewNormal.
DataMode Optional AcOpenDataMode An AcOpenDataMode constant that specifies the data entry mode for the query. The default value is acEdit.


You can use the OpenQuery method to open a select or crosstab query in Datasheet view, Design view, or Print Preview. This action runs an action query. You can also select a data entry mode for the query.


This method is only available in the Access database environment. See the OpenView or OpenStoredProcedure methods if you are using the Access Project environment (.adp).


The following example opens Sales Totals Query in Datasheet view and enables the user to view but not to edit or add records.

DoCmd.OpenQuery "Sales Totals Query", , acReadOnly

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.