Regras de Formatação para Strings de Conexão

Não existem verificações ou restrições internas sobre como formatar uma string de conexão. Este guia mostra as regras básicas para criar uma string de conexão que funcionará.

Estas são regras gerais adotadas pela maioria dos drivers e providers. No entanto, lembre-se de que essas regras não são 100% precisas para cada situação. Mesmo assim, seguir e conhecer essas regras básicas evitará alguns problemas comuns.

As regras

  • Todos os caracteres em branco, exceto aqueles colocados dentro de um valor ou entre aspas, são ignorados
  • Os caracteres em branco, no entanto, afetarão o mecanismo de pooling de conexões, as conexões agrupadas devem ter a mesma string de conexão exata
  • Se um ponto e vírgula (;) faz parte de um valor, ele deve ser delimitado por aspas (")
  • Use aspas simples (') se o valor começar com uma aspas duplas (")
  • Por outro lado, use aspas duplas (") se o valor começar com uma aspas simples (')
  • Não são suportadas sequências de escape
  • O tipo de valor não é relevante
  • Os nomes são insensíveis a maiúsculas e minúsculas
  • Se um par CHAVE=VALOR ocorrer mais de uma vez na string de conexão, o valor associado à última ocorrência será usado
  • No entanto, se a palavra-chave provedor ocorrer várias vezes na string, a primeira ocorrência é utilizada.
  • Se uma palavra-chave contiver um sinal de igual (=), deve ser precedida por um sinal de igual adicional para indicar que faz parte da palavra-chave.
  • Se um valor tiver espaços precedentes ou finais, deve ser incluído entre aspas simples ou duplas, por exemplo, Palavra-chave=" valor ", senão os espaços serão removidos.

Resumo

Conhecer essas regras básicas evitará erros difíceis de rastrear. Dedique algum tempo para entender essas regras e alguns minutos escolhendo quais parâmetros especificar ao conectar sua aplicação à fonte de dados.