In Operator (Microsoft Access SQL)

Determines whether the value of an expression is equal to any of several values in a specified list.

Syntax

expr [Not] In(value1, value2, …)

Remarks

The In operator syntax has these parts:

If expr is found in the list of values*,* the In operator returns True; otherwise, it returns False. You can include the Not logical operator to evaluate the opposite condition (that is, whether expr is not in the list of values).

For example, you can use In to determine which orders are shipped to a set of specified regions:

  SELECT *

  FROM Orders

  WHERE ShipRegion In ('Avon','Glos','Som')

Example

The following example uses the Orders table in the Northwind.mdb database to create a query that includes all orders shipped to Lancashire and Essex and the dates shipped.

This example calls the EnumFields procedure, which you can find in the SELECT statement example.

  Sub InX()
    Dim dbs As Database, rst As Recordset
    ' Modify this line to include the path to Northwind
    ' on your computer.
    Set dbs = OpenDatabase("Northwind.mdb")
    ' Select records from the Orders table that
    ' have a ShipRegion value of Lancashire or Essex.
    Set rst = dbs.OpenRecordset("SELECT " _
        & "CustomerID, ShippedDate FROM Orders " _
        & "WHERE ShipRegion In " _
        & "('Lancashire','Essex');")
    
    ' Populate the Recordset.
    rst.MoveLast
    
    ' Call EnumFields to print the contents of
    ' the Recordset.
    EnumFields rst, 12
    dbs.Close
End Sub

See Also

SQL Expressions

WHERE Clause (Microsoft Access SQL)