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 String.
Observações
Use a propriedade ConnectionString para especificar uma fonte de dados passando uma cadeia de conexão detalhada contendo uma série de argumentos = instruções de valor separadas por ponto-e-vírgula.
O ADO dá suporte a cinco argumentos para a propriedade ConnectionString; quaisquer outros argumentos passam diretamente para o provedor sem nenhum processamento pelo ADO. Os argumentos que o ADO dá suporte são os seguintes.
| Argumento | Descrição |
|---|---|
| Provider= | Especifica o nome de um provedor a ser usado para a conexão. |
| Nome do Arquivo= | 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. |
| Provedor Remoto= | Especifica o nome de um provedor a ser usado ao abrir uma conexão do lado do cliente. (Somente o Serviço de Dados Remoto.) |
| Servidor Remoto= | Especifica o nome do caminho do servidor a ser usado ao abrir uma conexão do lado do cliente. (Somente o Serviço de Dados Remoto.) |
| URL= | Especifica a cadeia de conexão como uma URL absoluta que identifica um recurso, como um arquivo ou diretório. |
Depois de definir a propriedade ConnectionString e abrir o objeto Connection, o provedor poderá alterar o conteúdo da propriedade, por exemplo, mapeando os nomes de argumento definidos pelo ADO para seus 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 de ConnectionString atual durante a chamada do método Open.
Como o argumento Nome do Arquivo faz com que o ADO carregue o provedor associado, você não pode passar os argumentos do Provedor de e Nome do Arquivo.
A propriedade ConnectionString é de leitura/gravação quando a conexão é fechada e somente leitura quando está aberta.
Duplicatas de um argumento na propriedade ConnectionString são ignoradas. A última instância de qualquer argumento é usada.
Nota
de Uso do Serviço de Dados Remoto quando usado em um objeto de Conexão do lado do cliente, a propriedade ConnectionString pode incluir apenas os parâmetros de provedor remoto e servidor remoto.
A tabela a seguir lista o provedor ADO padrão para cada sistema operacional Windows:
| Provedor ADO padrão | Sistema operacional Windows |
|---|---|
| MSDASQL (Para melhorar a legibilidade do código-fonte, especifique explicitamente o nome do provedor na cadeia de conexão.) |
Windows 2000 (32 bits) Windows XP (32 bits) Windows 2003 Server (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) |
| Nenhum padrão. Quando um aplicativo ADO é executado nos seguintes sistemas operacionais e não especifica o provedor explicitamente, o ADO retorna o seguinte erro: "ADODB. Conexão: o provedor não é especificado e não há nenhum provedor padrão designado" |
Windows 2000 (64 bits) Windows XP (64 bits) Windows 2003 Server (64 bits) Windows Vista (64 bits) |
Aplica-se a
do objeto de conexão (ADO)
Consulte Também
ConnectionString, ConnectionTimeout e exemplo de propriedades de estado (VB)
ConnectionString, ConnectionTimeout e exemplo de propriedades de estado (VC++)
apêndice A : provedores