Propriedade ConnectionString (ADO)
Indica as informações usadas para estabelecer uma conexão com uma fonte de dados.
Configurações e valores retornados
Define ou retorna um valor de String.
Comentários
Use a propriedade ConnectionString para especificar uma fonte de dados passando uma cadeia de conexão detalhada contendo uma série de instruções argument = value separadas por ponto-e-vírgula.
O ADO dá suporte a cinco argumentos para a propriedade ConnectionString. Todos os outros argumentos são transmitidos diretamente para o provedor sem nenhum processamento do ADO. Os argumentos aos quais o ADO dá suporte são mostrados a seguir.
| Argument | Descrição |
|---|---|
| Provider= | Especifica o nome de um provedor a ser usado para a conexão. |
| File Name= | Especifica o nome de um arquivo específico do provedor (por exemplo, um objeto de fonte de dados persistente) que contém informações de conexão predefinidas. |
| Remote Provider= | Especifica o nome de um provedor a ser usado ao abrir uma conexão do lado do cliente. (Somente Serviço de Dados Remotos.) |
| Remote Server= | Especifica o nome do caminho do servidor a ser usado ao abrir uma conexão do lado do cliente. (Somente Serviço de Dados Remotos.) |
| URL= | Especifica a cadeia de conexão como uma URL absoluta que identifica um recurso, como um arquivo ou um diretório. |
Depois que você definir a propriedade ConnectionString e abrir o objeto Connection, o provedor poderá alterar o conteúdo da propriedade, por exemplo, mapeando os nomes de argumentos definidos pelo ADO para os equivalentes para o provedor específico.
A propriedade ConnectionString herda automaticamente o valor usado para o argumento ConnectionString do método Open, para que você possa substituir a propriedade ConnectionString atual durante a chamada de método Open.
Como o argumento File Name faz com que o ADO carregue o provedor associado, não é possível transmitir os argumentos Provider e File Name.
A propriedade ConnectionString é de leitura/gravação quando a conexão é fechada e somente leitura quando ela é aberta.
As duplicatas de um argumento da propriedade ConnectionString são ignoradas. A última instância de qualquer argumento é usada.
Observação
Uso do Serviço de Dados Remotos Quando usada em um objeto Connection do lado do cliente, a propriedade ConnectionString pode incluir apenas os parâmetros Remote Provider e Remote Server.
A seguinte tabela lista o provedor ADO padrão para cada sistema operacional Windows:
| Provedor ADO padrão | Sistema operacional Windows |
|---|---|
| MSDASQL (Para aprimorar a leitura do código-fonte, especifique explicitamente o nome do provedor na cadeia de conexão.) |
Windows 2000 (32 bits) Windows XP (32 bits) Windows Server 2003 (32 bits) Windows Vista (32 bits) Windows Vista Service Pack 1 ou posterior (32 bits e 64 bits) Versões do Windows após o Windows Vista (32 bits e 64 bits) |
| Sem padrão. Quando um aplicativo ADO é executado nos seguintes sistemas operacionais e não especifica explicitamente o provedor, o ADO retorna o seguinte erro: "ADODB.Connection: o provedor não foi especificado e não há nenhum provedor padrão designado" |
Windows 2000 (64 bits) Windows XP (64 bits) Windows Server 2003 (64 bits) Windows Vista (64 bits) |
Aplica-se A
Confira também
Exemplo das propriedades ConnectionString, ConnectionTimeout e State (VB)
Exemplo das propriedades ConnectionString, ConnectionTimeout e State (VC++)
Apêndice A: Provedores