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 (designada pelo caractere '?') podem ser substituídos por argumentos correspondentes em um identificador na cadeia de caracteres de comando do cliente (designada por uma lista delimitada por vírgulas entre parênteses). The identifier and argument list behave like a function call.

Por exemplo, suponha que a cadeia de caracteres de comando do cliente seja "CustomerByID(4)", o cabeçalho da seção SQL seja [SQL CustomerByID] e a nova cadeia de caracteres da seção SQL seja "SELECT * FROM Customers WHERE CustomerID = ?". O Manipulador irá 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 string de instrução SQL não for válida, a execução da instrução falhará. O parâmetro client é 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