Seção SQL do arquivo de personalização

Aplica-se ao: Access 2013, Office 2013

A seção sql pode conter uma nova sequência de caracteres SQL que substitui a sequência de comando do cliente. Se a seção não tiver nenhuma sequência de caracteres SQL, ela será ignorada.

A nova cadeia de caracteres SQL pode ser parametrizada. Ou seja, os parâmetros na cadeia de caracteres SQL da seção sql (designados pelo caractere '?' podem ser substituídos por argumentos correspondentes em um identificador na cadeia de caracteres de comando do cliente (designado por uma lista delimitada por vírgula em parênteses). The identifier and argument list behave like a function call.

Por exemplo, suponha que a cadeia de comando do cliente seja "CustomerByID(4)" , o cabeçalho da seção SQL é [SQL CustomerByID] e a nova cadeia de caracteres da seção SQL é "SELECT * FROM Customers WHERE CustomerID = ?". O Manipulador gerará , o cabeçalho da seção SQL é [SQL CustomerByID] e a nova cadeia de caracteres da seção SQL é "SELECT * FROM Customers WHERE CustomerID = ?". O Manipulador gerará "SELECT * FROM Customers WHERE CustomerID = 4" e usará essa cadeia de caracteres para consultar a fonte de dados.

Se a nova sequência de caracteres SQL for a sequência nula (""), a seção será ignorada.

Se a nova cadeia de caracteres de instrução SQL não for válida, a execução da instrução falhará. O parâmetro cliente é efetivamente ignorado. Você pode fazer isso intencionalmente para "desativar" todos os comandos SQL do cliente especificando:

 
[SQL default] 
SQL = " " 

Sintaxe

Uma entrada de sequência de caracteres SQL de substituição tem este formato:

SQL=sqlString

Sair	Descrição
SQL	Uma sequência literal que indica uma entrada de seção SQL.
Sqlstring	Uma sequência de caracteres SQL que substitui a sequência de caracteres do cliente.