Propriedade ConnectionString (ADO)
Aplica-se ao: Access 2013, Office 2013
Indica as informações usadas para estabelecer uma conexão com uma fonte de dados.
Definições e valores devolvidos
Define ou retorna um valor String.
Comentários
Utilize a propriedade ConnectionString para especificar uma origem de dados ao transmitir uma cadeia de ligação detalhada que contém uma série de instruções de argumento= valores separadas por ponto e vírgula.
O ADO oferece suporte a cinco argumentos para a propriedade ConnectionString; quaisquer outros argumentos são passados diretamente para o provedorsem serem processados pelo ADO. Os argumentos aos quais o ADO oferece suporte são os seguintes.
Argumento |
Descrição |
|---|---|
Fornecedor= |
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) contendo informações de conexão predefinidas. |
Remote Provider= |
Especifica o nome do provedor a ser usado durante a abertura de uma conexão no cliente. (Apenas para o Remote Data Service.) |
Remote Server= |
Especifica o nome do caminho do servidor a ser usado ao abrir uma conexão do lado do cliente. (Apenas para o Remote Data Service.) |
URL= |
Especifica a cadeia de caracteres de conexão como uma URL absoluta que identifica um recurso, como um arquivo ou diretório. |
Depois que a propriedade ConnectionString for definida e o objeto Connection aberto, o provedor poderá alterar o conteúdo da propriedade, por exemplo, mapeando os nomes de argumento definidos pelo ADO para os seus equivalentes no provedor.
A propriedade ConnectionString herda automaticamente o valor usado para o argumento ConnectionString do método Open, de modo que você possa substituir a propriedade ConnectionString atual durante a chamada do método Open.
Como o argumento File Name faz com que o ADO carregue o provedor associado, não é possível passar ambos os argumentos, Provider e File Name.
A propriedade ConnectionString será leitura/gravação quando a conexão estiver fechada e somente leitura quando estiver aberta.
As duplicatas de um argumento na propriedade ConnectionString serão ignoradas. A última instância do argumento será usada.
Utilização do Serviço de Dados RemotoQuando utilizada num objeto de Ligação do lado do cliente, a propriedade ConnectionString só pode incluir os parâmetros Fornecedor Remoto e Servidor Remoto .