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

Objeto Connection (ADO)

Confira também

Exemplo das propriedades ConnectionString, ConnectionTimeout e State (VB)
Exemplo das propriedades ConnectionString, ConnectionTimeout e State (VC++)
Apêndice A: Provedores