Aspas em expressões de cadeia de caracteres

Em situações em que se devem construir cadeias de caracteres a serem concatenadas, talvez seja necessário embutir uma cadeia de caracteres em outra ou uma variável da cadeia em uma cadeia. Algumas das situações nas quais poderá ser necessário aninhar uma cadeia de caracteres em outra são:

• Ao especificar critérios para funções agregadas de domínio

• Ao especificar critérios para os métodos Find.

• Ao especificar critérios para a propriedade Filter ou ServerFilter de um formulário.

• Ao construir cadeias de caracteres SQL.

Em todas essas instâncias, o Access deve passar uma cadeia de caracteres para o mecanismo de banco de dados do Access. Quando você especifica um argumento criteria para uma função de agregação de domínio, por exemplo, o Access deve avaliar todas as variáveis, concatená-las em uma cadeia de caracteres e, em seguida, passar a cadeia de caracteres inteira para o mecanismo de banco de dados do Access.

Se você incorporar uma variável numérica, o Access avalia a variável e simplesmente concatenar o valor na cadeia de caracteres. No entanto, se a variável é uma cadeia de caracteres de texto, a sequência de critérios resultante conterá uma cadeia de caracteres dentro de uma sequência. Uma cadeia de caracteres em uma cadeia de caracteres deve ser identificada por delimitadores de cadeia de caracteres. Caso contrário, o mecanismo de banco de dados do Access não poderá determinar qual parte da cadeia de caracteres é o valor que você deseja usar.

Os delimitadores de cadeia de caracteres não são propriamente parte da variável, mas devem estar incluídos na cadeia no argumento criteria. Existem três maneiras diferentes de construir a cadeia de caracteres no argumento criteria. Cada método resulta em um argumento criteria semelhante a um dos exemplos a seguir.

"[LastName] = 'Smith'"

"[LastName] = ""Smith"""

Incluir aspas individuais

Você deve incluir aspas simples no argumento criteria de forma que, quando o valor da variável for concatenado na cadeia de caracteres, ele fique entre aspas simples. Por exemplo, suponha que o argumento de critérios contenha uma variável de cadeia de caracteres chamada strName. Você pode construir o argumento criteria como no exemplo a seguir:

"[LastName] = '" & strName & "'"

Quando a variável strName é avaliada e concatenada na cadeia de critérios , a cadeia de critérios se torna:

"[LastName] = 'Smith'"

Observação

Essa sintaxe não permite o uso de apóstrofos (') dentro do valor da variável em si. Se o valor da variável de cadeia de caracteres incluir um apóstrofo, o Access gerará um erro de tempo de execução. Se sua variável puder representar valores contendo apóstrofos, use uma das outras formas de sintaxe discutidas nas seções a seguir.

Incluir aspas duplas

Você deve incluir aspas duplas dentro do argumento criteria de forma que, quando o valor da variável for avaliado, ele fique entre aspas. Dentro de uma cadeia de caracteres, você deve usar dois conjuntos de aspas duplas para representar um único conjunto de aspas duplas. Você pode construir o argumento criteria como no exemplo a seguir:

"[LastName] = """ & strName & """"

Quando a variável strName é avaliada e concatenada no argumento de critérios , cada conjunto de duas aspas duplas é substituído por uma única cotação. O argumento criteria se tornará:

"[LastName] = 'Smith'"

Esta sintaxe pode parecer mais complicada que a sintaxe das aspas simples, mas permite inserir uma cadeia de caracteres que contenha um apóstrofo dentro do argumento criteria. Ela também permite aninhar uma ou mais sequência dentro da cadeia de caracteres inserida.

Incluir uma variável que representa aspas

Você pode criar uma variável de cadeia de caracteres que represente aspas duplas e concatenar essa variável no argumento criteria juntamente com o valor dessa variável. A representação ANSI para aspas duplas é Chr$(34); você pode atribuir esse valor a uma variável de cadeia de caracteres chamada strQuote. Em seguida, você pode construir o argumento criteria como no seguinte exemplo:

"[LastName] = " & strQuote & strName & strQuote

Quando as variáveis são avaliadas e concatenadas no argumento criteria, o argumento criteria torna-se:

[LastName] = "Smith"

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.