Report.RecordSource property (Access)
You can use the RecordSource property to specify the source of the data for a report. Read/write String.
expression A variable that represents a Report object.
The RecordSource property setting can be a table name, a query name, or an SQL statement. For example, you can use the following settings.
|Employees||A table name specifying the Employees table as the source of data.|
||An SQL statement specifying the OrderDate field on the Orders table as the source of data. You can bind a control on the form or report to the OrderDate field in the Orders table by setting the control's ControlSource property to OrderDate.|
Changing the record source of an open form or report causes an automatic requery of the underlying data. If a form's Recordset property is set at runtime, the form's RecordSource property is updated.
After you have created a form or report, you can change its source of data by changing the RecordSource property. The RecordSource property is also useful if you want to create a reusable form or report. For example, you could create a report that incorporates a standard design, and then copy the report and change the RecordSource property to display data from a different table, query, or SQL statement.
The following example sets a form's RecordSource property to the Customers table.
Forms!frmCustomers.RecordSource = "Customers"
The next example changes a form's record source to a single record in the Customers table, depending on the company name selected in the cmboCompanyName combo box control. The combo box is filled by an SQL statement that returns the customer ID (in the bound column) and the company name. The CustomerID has a Text data type.
Sub cmboCompanyName_AfterUpdate() Dim strNewRecord As String strNewRecord = "SELECT * FROM Customers " _ & " WHERE CustomerID = '" _ & Me!cmboCompanyName.Value & "'" Me.RecordSource = strNewRecord End Sub
The following example shows how to use a Structured Query Language (SQL) statement to establish the data source of a report as it is opened.
Private Sub Report_Open(Cancel As Integer) On Error GoTo Error_Handler Me.Caption = ?My Application? DoCmd.OpenForm FormName:=?frmReportSelector_MemberList?, _ Windowmode:=acDialog ?Cancel the report if ?cancel? was selected on the dialog form. If Forms!frmReportSelector_MemberList!txtContinue = ?no? Then Cancel = True GoTo Exit_Procedure End If Me.RecordSource = ReplaceWhereClause(Me.RecordSource, _ Forms!frmReportSelector_MemberList!txtWhereClause) Exit_Procedure: Exit Sub Error_Handler: MsgBox Err.Number & ?: ? & Err.Description Resume Exit_Procedure Resume End Sub
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.