SqlConnection.ConnectionString Propriedade

Definição

Obtém ou define a string usada para abrir uma base de dados do SQL Server.

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
public string ConnectionString { get; set; }
public override string ConnectionString { get; set; }
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
[<System.Data.DataSysDescription("SqlConnection_ConnectionString")>]
member this.ConnectionString : string with get, set
member this.ConnectionString : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set
Public Property ConnectionString As String
Public Overrides Property ConnectionString As String

Valor de Propriedade

A cadeia de ligação que inclui o nome da base de dados de origem e outros parâmetros necessários para estabelecer a ligação inicial. O valor padrão é uma cadeia de caracteres vazia.

Implementações

Atributos

Exceções

Foi fornecido um argumento de cadeia de ligação inválido, ou não foi fornecido um argumento de cadeia de ligação obrigatório.

Exemplos

O exemplo seguinte cria um SqlConnection e define a ConnectionString propriedade antes de abrir a ligação.

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();

    using (SqlConnection connection = new SqlConnection())
    {
        connection.ConnectionString = connectionString;

        connection.Open();

        Console.WriteLine("State: {0}", connection.State);
        Console.WriteLine("ConnectionString: {0}",
            connection.ConnectionString);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code,
    // you can retrieve it from a configuration file.
    return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
        + "Integrated Security=true;";
}
Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection()

        connection.ConnectionString = connectionString

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file.
    Return "Data Source=MSSQL1;Database=AdventureWorks;" _
      & "Integrated Security=true;"
End Function

Observações

O ConnectionString é semelhante a um cadeia de ligação OLE DB, mas não é idêntico. Ao contrário do OLE DB ou do ADO, o cadeia de ligação devolvido é o mesmo que o conjunto de utilizador ConnectionString, menos a informação de segurança se o valor Persistir Informação de Segurança estiver definido como false (predefinido). O .NET Framework Data Provider para SQL Server não persiste nem devolve a palavra-passe numa cadeia de ligação a menos que defina Persistir Informação de Segurança para true.

Pode usar a ConnectionString propriedade para se ligar a uma base de dados. O exemplo seguinte ilustra uma cadeia de ligação típica.

"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"

Use o novo SqlConnectionStringBuilder para construir cadeias de ligação válidas em tempo de execução. Para obter mais informações, consulte Construtores de cadeias de conexão.

A ConnectionString propriedade só pode ser definida quando a ligação está fechada. Muitos dos valores da cadeia de ligação têm propriedades correspondentes de apenas leitura. Quando a cadeia de ligação é definida, estas propriedades são atualizadas, exceto quando é detetado um erro. Neste caso, nenhuma das propriedades é atualizada. SqlConnection As propriedades retornam apenas as definições que estão contidas no ConnectionString.

Para se ligar a um computador local, especifique "(local)" para o servidor. Se o nome do servidor não for especificado, será tentada uma ligação à instância padrão no computador local.

Reiniciar o ConnectionString numa ligação fechada reinicia todos os valores cadeia de ligação (e propriedades relacionadas), incluindo a palavra-passe. Por exemplo, se definir uma cadeia de ligação que inclua "Database= AdventureWorks" e depois reiniciar a cadeia de ligação para "Data Source=myserver; Integrated Security=true", a propriedade Database já não está definida como "AdventureWorks".

A cadeia de ligação é analisada imediatamente após ser definida. Se forem encontrados erros de sintaxe durante a análise sintática, é gerada uma exceção em tempo de execução, como ArgumentException, Outros erros só podem ser encontrados quando se tenta abrir a ligação.

O formato básico de uma cadeia de ligação inclui uma série de pares palavra-chave/valor separados por ponto e vírgula. O sinal de igual (=) liga cada palavra-chave ao seu valor. Para incluir valores que contenham um carácter de ponto e vírgula, aspas simples ou aspas duplas, o valor deve estar incluído entre aspas duplas. Se o valor contiver tanto um ponto e vírgula como um carácter de aspas duplas, o valor pode ser incluído entre aspas simples. A aspas simples também é útil se o valor começar com aspas duplas. Por outro lado, a aspas dupla pode ser usada se o valor começar com uma única aspas. Se o valor contiver caracteres de aspas simples e duplas, o carácter de aspas usado para envolver o valor deve ser duplicado cada vez que ocorre dentro do valor.

Para incluir espaços anteriores ou finais no valor da cadeia, o valor deve estar incluído entre aspas simples ou aspas duplas. Quaisquer espaços iniciais ou finais em torno de valores inteiros, booleanos ou enumerados são ignorados, mesmo que estejam entre aspas. No entanto, os espaços dentro de uma palavra-chave ou valor literal são preservados. Aspas simples ou duplas podem ser usadas dentro de uma cadeia de ligação sem usar delimitadores (por exemplo, Data Source= my'Server ou Data Source= my"Server), a menos que um carácter de aspas seja o primeiro ou último carácter do valor.

As palavras-chave não são sensíveis a maiúsculas.

A tabela seguinte lista os nomes válidos para valores de palavras-chave dentro do ConnectionString.

Palavra-chave Predefinido Description
Addr N/A Sinónimo de fonte de dados.
Address N/A Sinónimo de fonte de dados.
App N/A Sinónimo de nome da aplicação.
Application Name N/A O nome da aplicação, ou '.NET SQLClient Data Provider', caso não seja fornecido o nome da aplicação.

O nome de uma aplicação pode ter 128 caracteres ou menos.
ApplicationIntent ReadWrite Declara o tipo de carga de trabalho do aplicativo ao se conectar a um servidor. Os valores possíveis são ReadOnly e ReadWrite. Por exemplo:

ApplicationIntent=ReadOnly

Para obter mais informações sobre o suporte do SqlClient para Grupos de Disponibilidade Always On, consulte Suporte do SqlClient para Alta Disponibilidade, Recuperação de Desastres.
Asynchronous Processing
-ou-
Async
'false' Quando true, permite o suporte de operações assíncronas. Os valores reconhecidos são true, false, yes, e no.

Esta propriedade é ignorada a partir do .NET Framework 4.5. Para mais informações sobre o suporte SqlClient para programação assíncrona, consulte Programação Assíncrona.
AttachDBFilename
-ou-
Extended Properties
-ou-
Initial File Name
N/A O nome do ficheiro principal da base de dados, incluindo o nome completo do caminho de uma base de dados anexável. O AttachDBFilename é suportado apenas para ficheiros de dados primários com uma extensão .mdf.

Se o valor da chave AttachDBFileName for especificado na cadeia de ligação, a base de dados é anexada e torna-se a base de dados padrão da ligação.

Se esta chave não for especificada e se a base de dados já estivesse anexada, a base de dados não será novamente ligada. A base de dados previamente anexada será usada como base de dados padrão para a ligação.

Se esta chave for especificada juntamente com a chave AttachDBFileName, o valor desta chave será usado como alias. No entanto, se o nome já for usado noutra base de dados anexada, a ligação falhará.

O caminho pode ser absoluto ou relativo usando a cadeia de substituição do DataDirectory. Se for usado DataDirectory, o ficheiro da base de dados deve existir dentro de um subdiretório do diretório apontado pela cadeia de substituição. Nota: Os nomes de caminhos de servidores remotos, HTTP e UNC não são suportados.

O nome da base de dados deve ser especificado com a palavra-chave 'base de dados' (ou um dos seus pseudónimos), conforme o seguinte:

"AttachDbFileName=&#124;DataDirectory&#124;\data\YourDB.mdf;integrated security=true;database=YourDatabase"

Será gerado um erro se existir um ficheiro de registo no mesmo diretório que o ficheiro de dados e a palavra-chave 'base de dados' for usada ao anexar o ficheiro de dados primário. Neste caso, remove o ficheiro de registo. Uma vez anexada a base de dados, um novo ficheiro de registo será automaticamente gerado com base no caminho físico.
Authentication N/A O método de autenticação utilizado para Ligação a uma base de dados SQL usando autenticação Azure Active Directory.

Os valores válidos são:

Active Directory Integrado, Palavra-passe Active Directory, Palavra-passe SQL.
Column Encryption Setting N/A Ativa ou desativa a funcionalidade Always Encrypted para a ligação.
Connect Timeout
-ou-
Connection Timeout
-ou-
Timeout
15 O período de tempo (em segundos) para aguardar uma conexão com o servidor antes de encerrar a tentativa e gerar um erro.

Os valores válidos são maiores ou iguais a 0 e menores ou iguais a 2147483647.

Ao abrir uma ligação a uma Base de Dados SQL do Azure, defina o timeout da ligação para 30 segundos.
Connection Lifetime
-ou-
Load Balance Timeout
0 Quando uma conexão é retornada ao pool, seu tempo de criação é comparado com o tempo atual e a conexão é destruída se esse intervalo de tempo (em segundos) exceder o valor especificado por Connection Lifetime. Isso é útil em configurações clusterizadas para forçar o balanceamento de carga entre um servidor em execução e um servidor recém-colocado online.

Um valor de zero (0) faz com que as ligações agrupadas tenham o tempo máximo de tempo de saída da ligação.
ConnectRetryCount 1 Controla o número de tentativas de reconexão após o cliente identificar uma falha de ligação inativa. Os valores válidos são de 0 a 255. O valor predefinido é 1. 0 significa não tentar reconectar (desativar a resiliência da ligação).

Para informações adicionais sobre resiliência da ligação, consulte .NET parâmetros SqlConnection para retentativa de ligação e Artigo Técnico - Resiliência da Ligação Ociosa.
ConnectRetryInterval 10 Especifica o tempo entre cada tentativa de retentativa de ligação (ConnectRetryCount). Os valores válidos são de 1 a 60 segundos (padrão=10), aplicados após a primeira tentativa de religação. Quando é detetada uma ligação quebrada, o cliente tenta imediatamente restabelecer; esta é a primeira tentativa de reconexão e só ocorre se o ConnectRetryCount for superior a 0. Se a primeira tentativa de reconexão falhar e o ConnectRetryCount for superior a 1, o cliente espera o ConnectRetryInterval para tentar a segunda e as subsequentes tentativas de reconexão.

Para informações adicionais sobre resiliência da ligação, consulte .NET parâmetros SqlConnection para retentativa de ligação e Artigo Técnico - Resiliência da Ligação Ociosa.
Context Connection 'false' true se deve ser feita uma ligação em processo a SQL Server.
Current Language
-ou-
Language
N/A Define a linguagem usada para mensagens de aviso ou erro do servidor de base de dados.

O nome da língua pode ter 128 caracteres ou menos.
Data Source
-ou-
Server
-ou-
Address
-ou-
Addr
-ou-
Network Address
N/A O nome ou endereço de rede da instância do SQL Server à qual se deve ligar. O número de porta pode ser especificado após o nome do servidor:

server=tcp:servername, portnumber

Ao especificar uma instância local, use sempre (local). Para forçar um protocolo, adicione um dos seguintes prefixos:

np:(local), tcp:(local), lpc:(local)

A partir do .NET Framework 4.5, também pode ligar-se a uma base de dados LocalDB da seguinte forma:

server=(localdb)\\myInstance

Para mais informações sobre o LocalDB, consulte Suporte SqlClient para LocalDB.

A Fonte de Dados deve utilizar o formato TCP ou o formato Named Pipes.

O formato TCP é o seguinte:

- TCP:<Nome> do Anfitrião\<Nome da Instância>
- tcp:<nome> do anfitrião,< número da porta TCP/IP>

O formato TCP deve começar com o prefixo "tcp:" e é seguido pela instância da base de dados, conforme especificado por um nome de host e um nome de instância. Este formato não é aplicável ao ligar ao Base de Dados SQL do Azure. O TCP é automaticamente selecionado para ligações ao Base de Dados SQL do Azure quando não é especificado nenhum protocolo.

O nome do anfitrião DEVE ser especificado de uma das seguintes formas:

- NetBIOSName
- Endereço IPv4
- Endereço IPv6

O nome da instância é usado para resolver para um número de porta TCP/IP específico onde uma instância de base de dados está alojada. Alternativamente, é permitido especificar diretamente um número de porta TCP/IP. Se o nome da instância e o número da porta não estiverem presentes, é utilizada a instância padrão da base de dados.

O formato Named Pipes é o seguinte:

- NP:\\<Nome> do Anfitrião\Pipe\<Nome do Pipe>

O formato Named Pipes DEVE começar com o prefixo "np:" e é seguido de um nome de pipe nomeado.

O nome do anfitrião DEVE ser especificado de uma das seguintes formas:

- NetBIOSName
- Endereço IPv4
- Endereço IPv6

O nome pipe é usado para identificar a instância da base de dados à qual a aplicação .NET Framework será ligada.

Se o valor da chave de rede for especificado, os prefixos "tcp:" e "np:" não devem ser especificados. Nota: Pode forçar o uso de TCP em vez de memória partilhada, seja prefixando tcp: ao nome do servidor no cadeia de ligação, ou usando localhost.
Encrypt 'false' Quando true, SQL Server utiliza encriptação SSL para todos os dados enviados entre o cliente e o servidor, caso o servidor tenha um certificado instalado. Os valores reconhecidos são true, false, yes, e no. Para obter mais informações, consulte Sintaxe da cadeia de conexão.

A partir .NET Framework 4.5, quando TrustServerCertificate for falso e Encrypt for verdadeiro, o nome do servidor (ou endereço IP) num certificado SSL SQL Server deve corresponder exatamente ao nome do servidor (ou endereço IP) especificado no cadeia de ligação. Caso contrário, a tentativa de ligação falhará.
Enlist 'true' true indica que o SQL Server pooler de ligação regista automaticamente a ligação no contexto atual da transação do thread de criação.
Failover Partner N/A O nome do servidor parceiro de failover onde o espelhamento de base de dados está configurado.

Se o valor desta chave for "", então o Catálogo Inicial deve estar presente, e o seu valor não pode ser "".

O nome do servidor pode ter 128 caracteres ou menos.

Se especificar um parceiro de failover mas o servidor parceiro de failover não estiver configurado para espelhamento de base de dados e o servidor principal (especificado com a palavra-chave do servidor) não estiver disponível, então a ligação falhará.

Se especificar um parceiro de failover e o servidor principal não estiver configurado para espelhamento de base de dados, a ligação ao servidor principal (especificada com a palavra-chave do servidor) terá sucesso se o servidor principal estiver disponível.
Initial Catalog
-ou-
Database
N/A O nome do banco de dados.

O nome da base de dados pode ter 128 caracteres ou menos.
Integrated Security
-ou-
Trusted_Connection
'false' Quando false, ID de utilizador e palavra-passe são especificados na ligação. Quando true, as credenciais atuais da conta Windows são usadas para autenticação.

Os valores reconhecidos são true, false, yes, no, e sspi (fortemente recomendado), o que é equivalente a true.

Se o ID de Utilizador e a Palavra-passe forem especificados e a Segurança Integrada estiver definida como verdadeira, o ID de Utilizador e a Palavra-passe serão ignorados e a Segurança Integrada será utilizada.

SqlCredential é uma forma mais segura de especificar credenciais para uma ligação que utiliza SQL Server Autenticação (Integrated Security=false).
Max Pool Size 100 O número máximo de ligações permitidas na piscina.

Os valores válidos são maiores ou iguais a 1. Valores inferiores ao Tamanho Mínimo do Pool geram um erro.
Min Pool Size 0 O número mínimo de ligações permitidas na piscina.

Os valores válidos são maiores ou iguais a 0. Zero (0) neste campo significa que não são abertas ligações mínimas inicialmente.

Valores superiores ao Tamanho Máximo do Pool geram um erro.
MultipleActiveResultSets 'false' Quando true, uma aplicação pode manter múltiplos conjuntos de resultados ativos (MARS). Quando false, uma aplicação deve processar ou cancelar todos os conjuntos de resultados de um lote antes de poder executar qualquer outro lote nessa ligação.

Os valores reconhecidos são true e false.

Para obter mais informações, consulte Vários conjuntos de resultados ativos (MARS).
MultiSubnetFailover FALSE Especifique sempre multiSubnetFailover=True ao ligar-se ao ouvinte do grupo de disponibilidade de um grupo de disponibilidade SQL Server de 2012 (ou posterior) ou de uma Instância de Cluster de Failover de SQL Server 2012 (ou posterior). multiSubnetFailover=True configura o SqlClient para proporcionar uma deteção e ligação mais rápidas ao servidor (atualmente) ativo. Os valores possíveis são Yes e No, True e False ou 1 e 0. Por exemplo:

MultiSubnetFailover=True

A predefinição é False. Para mais informações sobre o suporte do SqlClient para AGs Always On, consulte Suporte SqlClient para Alta Disponibilidade, Recuperação de Desastres.
Network Library
-ou-
Network
-ou-
Net
N/A A biblioteca de rede costumava estabelecer uma ligação a uma instância do SQL Server. Os valores suportados incluem:

dbnmpntw (Gaitas Nomeadas)

dbmsrpcn (Multiprotocolo, Windows RPC)

dbmsadsn (Apple Talk)

dbmsgnet (VIA)

dbmslpcn (Memória Partilhada)

dbmsspxn (IPX/SPX)

dbmssocn (TCP/IP)

Dbmsvinn (Vinhas Fiyan)

A DLL de rede correspondente deve estar instalada no sistema ao qual se liga. Se não especificar uma rede e usar um servidor local (por exemplo, "." ou "(local)"), é usada memória partilhada. Neste exemplo, a biblioteca de rede é Win32 Winsock TCP/IP (dbmssocn), e 1433 é a porta utilizada.

Network Library=dbmssocn;Data Source=000.000.000.000,1433;
Packet Size oito mil Tamanho em bytes dos pacotes de rede usados para comunicar com uma instância do SQL Server.

O tamanho do pacote pode ser maior ou igual a 512 e menor ou igual a 32768.
Password
-ou-
PWD
N/A A palavra-passe da conta do SQL Server a iniciar sessão. Não recomendado. Para manter um elevado nível de segurança, recomendamos vivamente que utilize a Integrated Security palavra-chave ou Trusted_Connection em vez disso. SqlCredential é uma forma mais segura de especificar credenciais para uma ligação que utiliza autenticação SQL Server.

A palavra-passe deve ter 128 caracteres ou menos.
Persist Security Info
-ou-
PersistSecurityInfo
'false' Quando definida como false ou no (fortemente recomendada), informações sensíveis à segurança, como a palavra-passe, não são devolvidas como parte da ligação se esta estiver aberta ou alguma vez esteve em estado aberto. Reiniciar a cadeia de ligação reinicia todos os valores da cadeia de ligação, incluindo a palavra-passe. Os valores reconhecidos são true, false, yes, e no.
PoolBlockingPeriod Auto Define o comportamento do período de bloqueio para um pool de ligações. Consulte PoolBlockingPeriod a propriedade para mais detalhes.
Pooling 'true' Quando o valor desta chave é definido como verdadeiro, qualquer ligação recém-criada será adicionada ao pool quando fechada pela aplicação. Numa próxima tentativa de abrir a mesma ligação, essa ligação será extraída da piscina.

As ligações são consideradas iguais se tiverem a mesma cadeia de ligação. Diferentes ligações têm cadeias de ligação diferentes.

O valor desta chave pode ser "verdadeiro", "falso", "sim" ou "não".
Replication 'false' true se a replicação for suportada usando a ligação.
Transaction Binding Desvinculação implícita Controla a associação de ligação com uma transação de praças System.Transactions .

Os valores possíveis são:

Transaction Binding=Implicit Unbind;

Transaction Binding=Explicit Unbind;

O Implicit Unbind faz com que a ligação se desligue da transação quando esta termina. Após o desacoplamento, são realizados pedidos adicionais na ligação em modo de autocommit. A System.Transactions.Transaction.Current propriedade não é verificada ao executar pedidos enquanto a transação está ativa. Após o término da transação, são realizados pedidos adicionais em modo de autocommit.

Se o sistema terminar a transação (no âmbito de um bloco de utilização) antes de o último comando ser concluído, irá lançar InvalidOperationException.

O Explicit Unbind faz com que a ligação permaneça ligada à transação até que a ligação seja fechada ou uma chamada explícita SqlConnection.TransactionEnlist(null) . A partir do .NET Framework 4, alterações ao Implicit Unbind tornam o Explicit Unbind obsoleto. Um InvalidOperationException é lançado se Transaction.Current não for a transação dos praças ou se a transação dos praças não estiver ativa.
TransparentNetworkIPResolution Ver descrição. Quando o valor desta chave é definido para true, a aplicação é obrigada a recuperar todos os endereços IP de uma determinada entrada DNS e tentar ligar-se ao primeiro da lista. Se a ligação não for estabelecida dentro de 0,5 segundos, a aplicação tentará ligar-se a todas as outras em paralelo. Quando o primeiro responde, a aplicação estabelecerá a ligação com o endereço IP do respondente.

Se a MultiSubnetFailover tonalidade estiver definida para true, TransparentNetworkIPResolution é ignorada.

Se a Failover Partner chave estiver definida, TransparentNetworkIPResolution é ignorada.

O valor desta chave deve ser true, false, yes, ou no.

Um valor de yes é tratado da mesma forma que um valor de true.

Um valor de no é tratado da mesma forma que um valor de false.

Os valores predefinidos são os seguintes:

  • false Quando:

    • Ligação ao Base de Dados SQL do Azure, onde a fonte de dados termina em:

      • .database.chinacloudapi.cn
      • .database.usgovcloudapi.net
      • .database.cloudapi.de
      • .database.windows.net
    • Authentication é 'Active Directory Password' ou 'Active Directory Integrated'
  • true em todos os outros casos.
TrustServerCertificate 'false' Quando definido para true, SSL é usado para encriptar o canal ao contornar a cadeia de certificados para validar a confiança. Se o TrustServerCertificate estiver definido para true e Encrypt para false, o canal não está encriptado. Os valores reconhecidos são true, false, yes, e no. Para obter mais informações, consulte Sintaxe da cadeia de conexão.
Type System Version N/A Um valor de cadeia que indica o sistema de tipos que a aplicação espera. A funcionalidade disponível para uma aplicação cliente depende da versão do SQL Server e do nível de compatibilidade da base de dados. Definir explicitamente a versão do sistema de tipos para a qual a aplicação cliente foi escrita evita potenciais problemas que possam causar a falha de uma aplicação se for usada uma versão diferente do SQL Server. Nota: A versão do sistema de tipos não pode ser definida para código em tempo de execução de linguagem comum (CLR) a ser executado em processo em SQL Server. Para mais informações, veja SQL Server Common Language Runtime Integration.

Os valores possíveis são:

Type System Version=SQL Server 2012;

Type System Version=SQL Server 2008;

Type System Version=SQL Server 2005;

Type System Version=Latest;

Type System Version=SQL Server 2012; especifica que a aplicação exigirá a versão 11.0.0.0 de Microsoft.SqlServer.Types.dll. As outras definições Type System Version exigirão a versão 10.0.0.0 do Microsoft.SqlServer.Types.dll.

Latest é obsoleta e não deve ser utilizada. Latest é equivalente a Type System Version=SQL Server 2008;.
User ID
-ou-
UID
-ou-
User
N/A A conta de login do SQL Server. Não recomendado. Para manter um elevado nível de segurança, recomendamos vivamente que utilize as Integrated Security palavras-chave ou Trusted_Connection . SqlCredential é uma forma mais segura de especificar credenciais para uma ligação que utiliza autenticação SQL Server.

O ID do utilizador deve ter 128 caracteres ou menos.
User Instance 'false' Um valor que indica se deve redirecionar a ligação da instância padrão do SQL Server Express para uma instância iniciada em tempo de execução a correr sob a conta do chamador.
Workstation ID
-ou-
WSID
O nome do computador local O nome da estação de trabalho ligada ao SQL Server.

O ID deve ter 128 caracteres ou menos.

A lista seguinte contém os nomes válidos para os valores de agregação de ligações dentro do ConnectionString. Para obter mais informações, consulte Pool de conexões do SQL Server (ADO.NET).

  • Connection Lifetime (ou Load Balance Timeout)
  • Enlist
  • Max Pool Size
  • Min Pool Size
  • Pooling

Quando defines valores de pooling de palavras-chave ou de ligação que exigem um valor booleano, podes usar yes em vez de true, e no em vez de false. Os valores inteiros são representados como cadeias.

Note

O .NET Framework Data Provider for SQL Server utiliza o seu próprio protocolo para comunicar com o SQL Server. Por isso, não suporta o uso de um nome de fonte de dados ODBC (DSN) ao ligar-se ao SQL Server porque não adiciona uma camada ODBC.

Note

Os ficheiros de ligação universal de dados (UDL) não são suportados para o .NET Framework Data Provider for SQL Server.

Caution

Tenha cautela ao construir uma cadeia de ligação baseada na entrada do utilizador (por exemplo, ao recuperar informações de ID de utilizador e palavra-passe de uma caixa de diálogo e anexá-las à cadeia de ligação). Certifique-se de que um utilizador não pode incorporar parâmetros adicionais de cadeia de ligação nestes valores (por exemplo, inserir uma palavra-passe como "validpassword; database=somedb" numa tentativa de se ligar a uma base de dados diferente). Se precisares de construir strings de ligação baseadas na entrada do utilizador, usa SqlConnectionStringBuilder, que valida o cadeia de ligação e ajuda a eliminar este problema. Para obter mais informações, consulte Construtores de cadeias de conexão.

Aplica-se a

Ver também