How to: Include Quotation Marks in String Expressions
Access Developer Reference |
In situations where you must construct strings to be concatenated, you may need to embed a string within another string, or a string variable within a string. Situations in which you might need to nest one string within another include:
- When specifying criteria for domain aggregate functions.
- When specifying criteria for the Find methods.
- When specifying criteria for the Filter or ServerFilter property of a form.
- When building SQL strings.
In all of these instances, Microsoft Access must pass a string to the Microsoft Access database engine. When you specify a criteria argument for a domain aggregate function, for example, Microsoft Access must evaluate any variables, concatenate them into a string, and then pass the entire string to the Access database engine.
If you embed a numeric variable, Microsoft Access evaluates the variable and simply concatenates the value into the string. If the variable is a text string, however, the resulting criteria string will contain a string within a string. A string within a string must be identified by string delimiters. Otherwise, the Access database engine will not be able to determine which part of the string is the value you want to use.
The string delimiters are not actually part of the variable itself, but they must be included in the string in the criteria argument. There are three different ways to construct the string in the criteria argument. Each method results in a criteria argument that looks like one of the following examples.
|
– or –
|
Include Single Quotation Marks
You should include single quotation marks in the criteria argument in such a way that when the value of the variable is concatenated into the string, it will be enclosed within the single quotation marks. For instance, suppose your criteria argument must contain a string variable called
|
. You could construct the criteria argument as in the following example:
|
When the variable strName
is evaluated and concatenated into the criteria string, the criteria string becomes:
|
Note |
---|
This syntax does not permit the use of apostrophes (') within the value of the variable itself. If the value of the string variable includes an apostrophe, Microsoft Access generates a run-time error. If your variable may represent values containing apostrophes, consider using one of the other syntax forms discussed in the following sections. |
Include Double Quotation Marks
You should include double quotation marks within the criteria argument in such a way so that when the value of the variable is evaluated, it will be enclosed within the quotation marks. Within a string, you must use two sets of double quotation marks to represent a single set of double quotation marks. You could construct the criteria argument as in the following example:
|
When the variable strName
is evaluated and concatenated into the criteria argument, each set of two double quotation marks is replaced by one single quotation mark. The criteria argument becomes:
|
This syntax may appear more complicated than the single quotation mark syntax, but it enables you to embed a string that contains an apostrophe within the criteria argument. It also enables you to nest one or more strings within the embedded string.
Include a Variable Representing Quotation Marks
You can create a string variable that represents double quotation marks, and concatenate this variable into the criteria argument along with the value of the variable. The ANSI representation for double quotation marks is Chr$(34)
; you could assign this value to a string variable called strQuote
. You could then construct the criteria argument as in the following example:
|
When the variables are evaluated and concatenated into the criteria argument, the criteria argument becomes:
|