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 transmitindo 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.

Argumento	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)

Consulte Também

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