Compartilhar via


SqlConnection.ConnectionString Propriedade

Definição

Obtém ou define a cadeia de caracteres usada para abrir um banco de dados do SQL Server.

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

Valor da propriedade

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

Atributos

Exceções

Um argumento de cadeia de conexão inválido foi fornecido ou não foi fornecido um argumento de cadeia de conexão necessário.

Exemplos

O exemplo a seguir cria um SqlConnection e define a ConnectionString propriedade antes de abrir a conexão.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    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;";
    }
}

Comentários

O ConnectionString é semelhante a um cadeia de conexão OLE DB, mas não é idêntico. Ao contrário do OLE DB ou do ADO, o cadeia de conexão retornado é o mesmo que o conjunto ConnectionStringde usuários , menos as informações de segurança se o valor Persist Security Info for definido false como (padrão). O provedor de dados .NET Framework para SQL Server não persiste ou retorna a senha em um cadeia de conexão, a menos que você defina Persistir Informações de Segurança como true.
Você pode usar a ConnectionString propriedade para se conectar a um banco de dados. O exemplo a seguir ilustra um cadeia de conexão típico.

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

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

A ConnectionString propriedade só pode ser definida quando a conexão é fechada. Muitos dos valores de cadeia de conexão têm propriedades somente leitura correspondentes. Quando o cadeia de conexão é definido, essas propriedades são atualizadas, exceto quando um erro é detectado. Nesse caso, nenhuma das propriedades é atualizada. SqlConnection as propriedades retornam apenas as configurações contidas no ConnectionString.

Para se conectar a um computador local, especifique "(local)" para o servidor. Se um nome de servidor não for especificado, uma conexão será tentada com a instância padrão no computador local.

Redefinir o ConnectionString em uma conexão fechada redefine todos os valores de cadeia de conexão (e propriedades relacionadas), incluindo a senha. Por exemplo, se você definir um cadeia de conexão que inclua "Database= AdventureWorks" e redefinir o cadeia de conexão como "Data Source=myserver; Integrated Security=true", a Database propriedade não está mais definida como "AdventureWorks".

O cadeia de conexão é analisado imediatamente após ser definido. Se forem encontrados erros na sintaxe ao analisar, uma exceção de runtime, como ArgumentException, será gerada. Outros erros só podem ser encontrados quando é feita uma tentativa de abrir a conexão.

O formato básico de uma cadeia de conexão inclui uma série de pares de palavra-chave/valor separados por ponto e vírgula. O sinal de igual (=) conecta cada palavra-chave e seu valor. Para incluir valores que contêm um ponto e vírgula, um caractere de aspas simples ou um caractere de aspas duplas, o valor deve ser colocado entre aspas duplas. Se o valor contiver um ponto e vírgula e um caractere de aspas duplas, o valor poderá ser colocado entre aspas simples. A aspa única também será útil se o valor começar com um caractere de aspas duplas. Por outro lado, a aspa dupla poderá ser usada se o valor começar com uma única aspa. Se o valor contiver caracteres de aspas simples e aspas duplas, o caractere de aspas usado para colocar o valor deve ser duplicado sempre que ocorrer dentro do valor.

Para incluir espaços anteriores ou à direita no valor da cadeia de caracteres, o valor deve ser colocado entre aspas simples ou aspas duplas. Todos os espaços à esquerda ou à direita em torno de valores inteiros, boolianos ou enumerados são ignorados, mesmo que entre aspas. No entanto, os espaços dentro de um literal de cadeia de caracteres palavra-chave ou valor são preservados. Aspas simples ou duplas podem ser usadas em um cadeia de conexão sem usar delimitadores (por exemplo, Fonte de Dados= my'Server ou Fonte de Dados= meu"Servidor), a menos que um caractere de aspas seja o primeiro ou o último caractere no valor.

Palavras-chave não diferenciam maiúsculas de minúsculas.

A tabela a seguir lista os nomes válidos para valores palavra-chave dentro do ConnectionString.

Palavra-chave Padrão Descrição
Addr N/D Sinônimo de Fonte de Dados.
Endereço N/D Sinônimo de Fonte de Dados.
Aplicativo N/D Sinônimo de Nome do Aplicativo.
Tentativa de aplicativo

-ou-

ApplicationIntent
ReadWrite Declara o tipo de carga de trabalho de aplicativo ao conectar-se a um servidor. Os valores possíveis são ReadOnly e ReadWrite. Por exemplo:

ApplicationIntent=ReadOnly

Para saber mais sobre o suporte ao SqlClient para Grupos de Disponibilidade AlwaysOn, confira Suporte do SqlClient para alta disponibilidade e recuperação de desastres.
Nome do Aplicativo N/D O nome do aplicativo. Se nenhum nome de aplicativo for fornecido, 'Framework Microsoft SqlClient Data Provider' ao executar em .NET Framework e 'Provedor de Dados Principais do Microsoft SqlClient' caso contrário.

Um nome de aplicativo pode ter 128 caracteres ou menos.
AttachDBFilename

- ou -

Propriedades estendidas

- ou -

Nome do Arquivo Inicial
N/D O nome do arquivo de banco de dados primário, incluindo o nome do caminho completo de um banco de dados anexável. AttachDBFilename só tem suporte para arquivos de dados primários com uma extensão .mdf.

Se o valor da chave AttachDBFileName for especificado no cadeia de conexão, o banco de dados será anexado e se tornará o banco de dados padrão para a conexão.

Se essa chave não for especificada e se o banco de dados tiver sido anexado anteriormente, o banco de dados não será reanexado. O banco de dados anexado anteriormente será usado como o banco de dados padrão para a conexão.

Se essa chave for especificada junto com a chave AttachDBFileName, o valor dessa chave será usado como alias. No entanto, se o nome já estiver usado em outro banco de dados anexado, a conexão falhará.

O caminho pode ser absoluto ou relativo usando a cadeia de caracteres de substituição DataDirectory. Se DataDirectory for usado, o arquivo de banco de dados deverá existir em um subdiretório do diretório apontado pela cadeia de caracteres de substituição. Nota: Não há suporte para nomes de caminho de servidor remoto, HTTP e UNC.

O nome do banco de dados deve ser especificado com o palavra-chave 'database' (ou um de seus aliases) como no seguinte:

"AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase"

Um erro será gerado se um arquivo de log existir no mesmo diretório que o arquivo de dados e o palavra-chave 'banco de dados' for usado ao anexar o arquivo de dados primário. Nesse caso, remova o arquivo de log. Depois que o banco de dados for anexado, um novo arquivo de log será gerado automaticamente com base no caminho físico.
Protocolo de atestado NotSpecified Obtém ou define o valor do Protocolo de Atestado.

Quando nenhum valor é especificado, enclaves seguros são desabilitados na conexão.

Os valores válidos são:
AAS
HGS
None (Válido somente em v3.1 e v4.1+))
Autenticação N/D O método de autenticação usado para conectar-se a Banco de Dados SQL usando a Autenticação do Azure Active Directory.

Os valores válidos são:

Active Directory Integrated, Active Directory Interactive, Active Directory Password, Active Directory Service Principal, Active Directory Device Code Flow, Active Directory Managed Identity, Active Directory MSI, Active Directory Default, Sql Password.

Para obter informações adicionais, consulte Usando a autenticação do Azure Active Directory com o SqlClient.
Configuração da criptografia de coluna desabilitado Habilita ou desabilita Always Encrypted funcionalidade para a conexão. Os valores com suporte são: enabled e disabled
Tempo limite de comando 30 O tempo de espera padrão (em segundos) antes de encerrar a tentativa de executar um comando e gerar um erro.

Os valores válidos são maiores ou iguais a 0 e menores ou iguais a 2147483647.
Contagem de repetições de conexão

-ou-

ConnectRetryCount
1 Controla o número de tentativas de reconexão depois que o cliente identifica uma falha de conexão ociosa. Os valores válidos são de 0 a 255. 0 significa não tentar se reconectar (desabilitar a resiliência da conexão).

Observação: como a versão 5.x, o valor padrão para pontos de extremidade não Azure é 1. Para pontos de extremidade SQL do Azure, o padrão é 2. Para SQL do Azure pontos de extremidade sem servidor ou sob demanda, o padrão é 5 para melhorar o sucesso da conexão para conexões com uma instância ociosa ou em pausa.

Para obter informações adicionais sobre resiliência de conexão ociosa, consulte Parâmetros do .NET SqlConnection para repetição de conexão e Artigo Técnico – Resiliência de Conexão Ociosa.
Intervalo de repetição de conexão

-ou-

ConnectRetryInterval
10 Especifica o tempo entre cada tentativa de repetição de conexão (ConnectRetryCount). Os valores válidos são de 1 a 60 segundos (default=10), aplicados após a primeira tentativa de reconexão. Quando uma conexão interrompida é detectada, o cliente tenta se reconectar imediatamente; essa é a primeira tentativa de reconexão e só ocorre se ConnectRetryCount for maior que 0. Se a primeira tentativa de reconexão falhar e ConnectRetryCount for maior que 1, o cliente aguardará ConnectRetryInterval para tentar a segunda e subsequentes tentativas de reconexão.

Para obter informações adicionais sobre resiliência de conexão ociosa, consulte Parâmetros sqlConnection do .NET para repetição de conexão e Artigo Técnico – Resiliência de Conexão Ociosa.
Connect Timeout

- ou -

Tempo-limite da conexão

- ou -

Tempo limite
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 conexão com um banco de dados SQL do Azure, defina o tempo limite da conexão como 30 segundos.
Idioma Atual

- ou -

Idioma
N/D Define o idioma usado para mensagens de aviso ou erro do servidor de banco de dados.

O nome do idioma pode ter 128 caracteres ou menos.
fonte de dados

- ou -

Servidor

- ou -

Endereço

- ou -

Addr

- ou -

Endereço de Rede
N/D O nome ou o endereço de rede da instância do SQL Server ao qual se conectar. O número da porta pode ser especificado após o nome do servidor:

server=tcp:servername, portnumber

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

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

Você também pode se conectar a um banco de dados LocalDB da seguinte maneira:

server=(localdb)\\myInstance

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

A Fonte de Dados deve usar o formato TCP ou o formato Pipes Nomeados.

O formato TCP é o seguinte:

- tcp:<host name>\<instance name>
- tcp:nome> do< host,< número da porta TCP/IP>

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

O nome do host DEVE ser especificado de uma das seguintes maneiras:

- NetBIOSName
- IPv4Address
-Endereço_ipv6

O nome da instância é usado para resolve a um número de porta TCP/IP específico no qual uma instância de banco de dados está hospedada. Como alternativa, a especificação de um número de porta TCP/IP diretamente também é permitida. Se o nome da instância e o número da porta não estiverem presentes, a instância de banco de dados padrão será usada.

O formato Pipes Nomeados é o seguinte:

- np:\\<nome> do host\pipe\<nome do pipe>

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

O nome do host DEVE ser especificado de uma das seguintes maneiras:

- NetBIOSName
- IPv4Address
-Endereço_ipv6

O nome do pipe é usado para identificar a instância do banco de dados à qual o aplicativo .NET se conectará.

Se o valor da chave de rede for especificado, os prefixos "tcp:" e "np:" não deverão ser especificados. Nota: Você pode forçar o uso de TCP em vez de memória compartilhada, prefixando tcp: no nome do servidor no cadeia de conexão ou usando localhost.
URL de Atestado de Enclave N/D Obtém ou define a URL de atestado de enclave a ser usada com Always Encrypted baseadas em enclave.
Encrypt 'true' em 4.0 e superior

'false' em 3.x e abaixo
Os valores reconhecidos são:
versões 1 a 4: true/yes e false/no
versões 5+: true//yesmandatorye .strictfalse/no/optional Quando true, a criptografia TLS é usada para todos os dados enviados entre o cliente e o servidor se o servidor tiver um certificado instalado. Quando strict, a criptografia TLS TDS 8.0 é usada e a TrustServerCertificate configuração é ignorada e tratada como false. Para saber mais, confira Sintaxe de cadeia de conexão.

Quando Encrypt é mandatory ou strict e TrustServerCertificate é false, o nome do servidor (ou endereço IP) no certificado de um servidor deve corresponder exatamente ao nome do servidor (ou endereço IP) especificado no cadeia de conexão. Caso contrário, a tentativa de conexão falhará.
Alistar 'true' trueindica que o pooler de conexões SQL Server inscreve automaticamente a conexão no contexto de transação atual do thread de criação.
Failover Partner N/D O nome do servidor de parceiro de failover em que o espelhamento de banco de dados está configurado.

Se o valor dessa chave for "", o Catálogo Inicial deverá estar presente e seu valor não deverá ser "".

O nome do servidor pode ter 128 caracteres ou menos.

Se você especificar um parceiro de failover, mas o servidor parceiro de failover não estiver configurado para espelhamento de banco de dados e o servidor primário (especificado com o servidor palavra-chave) não estiver disponível, a conexão falhará.

Se você especificar um parceiro de failover e o servidor primário não estiver configurado para espelhamento de banco de dados, a conexão com o servidor primário (especificada com o servidor palavra-chave) terá êxito se o servidor primário estiver disponível.
SPN do parceiro de failover:

-ou-

FailoverPartnerSPN
N/D O SPN do parceiro de failover. O valor padrão é uma cadeia de caracteres vazia, o que faz com que o SqlClient use o SPN padrão gerado pelo driver.

(Disponível apenas na v5.0+)
Nome do host no certificado

-ou-

HostNameInCertificate
N/D O nome do host a ser usado ao validar o certificado do servidor. Quando não especificado, o nome do servidor da Fonte de Dados é usado para validação de certificado.

(Disponível apenas na v5.0+)
Certificado de servidor

-ou-

ServerCertificate
N/D O caminho para um arquivo de certificado a ser correspondido com o certificado TLS/SSL SQL Server. Os formatos de certificado aceitos são PEM, DER e CER. Se especificado, o certificado SQL Server será verificado verificando se o ServerCertificate fornecido é uma correspondência exata.

(Disponível apenas na v5.1+)
Catálogo Inicial

- ou -

Banco de dados
N/D O nome do banco de dados.

O nome do banco de dados pode ter 128 caracteres ou menos.
Segurança Integrada

- ou -

Trusted_Connection
'false' Quando false, id de usuário e senha são especificados na conexão. Quando true, as credenciais atuais da conta do Windows são usadas para autenticação.

Os valores reconhecidos são true, false, yes, noe sspi (altamente recomendado), que é equivalente a true.

Se a ID de Usuário e a Senha forem especificadas e a Segurança Integrada estiver definida como true, a ID de Usuário e a Senha serão ignoradas e a Segurança Integrada será usada.

SqlCredentialé uma maneira mais segura de especificar credenciais para uma conexão que usa a Autenticação de SQL Server (Integrated Security=false).
Preferência de endereço IP

-ou-

IPAddressPreference
IPv4First A preferência da família de endereços IP ao estabelecer conexões TCP. Se Transparent Network IP Resolution (em .NET Framework) ou Multi Subnet Failover estiver definido como true, essa configuração não terá efeito. Os valores compatíveis incluem:

IPAddressPreference=IPv4First

IPAddressPreference=IPv6First

IPAddressPreference=UsePlatformDefault
Tempo limite do balanceamento de carga

-ou-

Tempo de vida da conexão
0 Quando uma conexão é retornada para o pool, seu tempo de criação é comparado com a hora atual e a conexão será destruída se esse intervalo de tempo (em segundos) exceder o valor especificado por Connection Lifetime. Isso é útil nas configurações clusterizadas para forçar o balanceamento de carga entre um servidor em execução e um servidor que acabou de ficar online.

Um valor zero (0) faz com que as conexões em pool tenham o tempo limite máximo de conexão.
Tamanho Máx do Pool 100 O número máximo de conexões permitidas no pool.

Os valores válidos são maiores ou iguais a 1. Valores menores que o Tamanho do Pool Mínimo geram um erro.
Tamanho mínimo do pool 0 O número mínimo de conexões permitidas no pool.

Os valores válidos são maiores ou iguais a 0. Zero (0) nesse campo significa que nenhuma conexão mínima é aberta inicialmente.

Valores maiores que o Tamanho Máximo do Pool geram um erro.
Conjuntos de resultados ativos múltiplos

-ou-

MultipleActiveResultSets
false Quando true, um aplicativo pode manter vários conjuntos de resultados ativos (MARS). Quando false, um aplicativo deve processar ou cancelar todos os conjuntos de resultados de um lote antes de poder executar qualquer outro lote nessa conexão.

Os valores reconhecidos são true e false.

Para obter mais informações, confira MARS (Conjunto de Resultados Ativos Múltiplos).
Failover de várias sub-redes

-ou-

MultiSubnetFailover
false Sempre especifique multiSubnetFailover=True ao se conectar ao ouvinte do grupo de disponibilidade de um grupo de disponibilidade SQL Server 2012 (ou posterior) ou a uma Instância de Cluster de Failover SQL Server 2012 (ou posterior). multiSubnetFailover=True configura o SqlClient para fornecer detecção e conexão mais rápidas com o servidor ativo (atualmente). Os valores possíveis são Yes e No, True e False ou e 1 e 0. Por exemplo:

MultiSubnetFailover=True

O padrão é False. Para obter mais informações sobre o suporte do SqlClient para Always On AGs, consulte Suporte do SqlClient para alta disponibilidade e recuperação de desastres.
Biblioteca de rede

- ou -

Rede

- ou -

Net
N/D A biblioteca de rede usada para estabelecer uma conexão com uma instância de SQL Server. Os valores compatíveis incluem:

dbnmpntw (Pipes Nomeados)

dbmsrpcn (Multiprotocol, Windows RPC)

dbmsadsn (Apple Talk)

dbmsgnet (VIA)

dbmslpcn (Memória Compartilhada)

dbmsspxn (IPX/SPX)

dbmssocn (TCP/IP)

Dbmsvinn (Banyan Vines)

A DLL de rede correspondente deve ser instalada no sistema ao qual você se conecta. Se você não especificar uma rede e usar um servidor local (por exemplo, "." ou "(local)"), a memória compartilhada será usada. Neste exemplo, a biblioteca de rede é Win32 Winsock TCP/IP (dbmssocn) e 1433 é a porta que está sendo usada.

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

O tamanho do pacote pode ser maior ou igual a 512 e menor ou igual a 32768.
Senha

- ou -

PWD
N/D A senha do logon da conta SQL Server. Não recomendável. Para manter um alto nível de segurança, é altamente recomendável que você use o Integrated Security ou Trusted_Connection palavra-chave em vez disso. SqlCredentialé uma maneira mais segura de especificar credenciais para uma conexão que usa SQL Server Autenticação.

A senha deve ter 128 caracteres ou menos.
Informações de Persistência de Segurança

- ou -

Persistsecurityinfo
'false' Quando definidas false como ou no (altamente recomendadas), as informações confidenciais de segurança, como a senha ou o token de acesso, não são retornadas como parte da conexão se a conexão estiver aberta ou nunca estiver em um estado aberto. Essa propriedade só deve ser definida true como se seu aplicativo tiver uma necessidade específica de ler a senha de uma conexão de banco de dados já aberta. O valor padrão de false é a configuração mais segura; usar true para essa propriedade abre seu aplicativo para riscos de segurança, como fazer logon acidentalmente ou rastrear a senha do banco de dados.

Redefinir o cadeia de conexão redefine todos os valores cadeia de conexão, incluindo a senha. Os valores reconhecidos são true, false, yes e no.
Período de bloqueio do pool

-ou-

PoolBlockingPeriod
Auto Define o comportamento do período de bloqueio para um pool de conexões. Consulte a propriedade PoolBlockingPeriod para obter detalhes.
Agrupamento 'true' Quando o valor dessa chave for definido como true, qualquer conexão recém-criada será adicionada ao pool quando fechada pelo aplicativo. Em uma próxima tentativa de abrir a mesma conexão, essa conexão será extraída do pool.

Connections são considerados iguais se tiverem o mesmo cadeia de conexão. Conexões diferentes têm cadeias de conexão diferentes.

O valor dessa chave pode ser "true", "false", "yes" ou "no".
Replicação 'false' true se houver suporte para replicação usando a conexão.
SPN do servidor

-ou-

ServerSPN
N/D O SPN para a fonte de dados. O valor padrão é uma cadeia de caracteres vazia, o que faz com que o SqlClient use o SPN padrão gerado pelo driver.

(Disponível apenas na v5.0+)
Associação de transação Desassociação implícita Controla a associação de conexão com uma transação inscrita System.Transactions .

Os valores possíveis são:

Transaction Binding=Implicit Unbind;

Transaction Binding=Explicit Unbind;

A desassociação implícita faz com que a conexão se desanexe da transação quando termina. Após a desanexação, solicitações adicionais na conexão são executadas no modo de confirmação automática. A System.Transactions.Transaction.Current propriedade não é verificada ao executar solicitações enquanto a transação está ativa. Após o término da transação, solicitações adicionais são executadas no modo de confirmação automática.

Se o sistema terminar a transação (no escopo de um bloco de uso) antes da conclusão do último comando, ele gerará InvalidOperationException.

A desassociação explícita faz com que a conexão permaneça anexada à transação até que a conexão seja fechada ou um explícito SqlConnection.TransactionEnlist(null) seja chamado. A partir do .NET Framework 4.0, as alterações na Desassociação Implícita tornam a Desassociação Explícita obsoleta. Um InvalidOperationException será gerado se Transaction.Current não for a transação inscrita ou se a transação inscrita não estiver ativa.
Resolução IP de Rede Transparente

-ou-

TransparentNetworkIPResolution
Confira a descrição. Quando o valor dessa chave é definido como true, o aplicativo é necessário para recuperar todos os endereços IP para uma determinada entrada DNS e tentar se conectar à primeira na lista. Se a conexão não for estabelecida em 0,5 segundos, o aplicativo tentará se conectar a todos os outros paralelamente. Quando o primeiro responder, o aplicativo estabelecerá a conexão com o endereço IP do respondedor.

Se a MultiSubnetFailover chave estiver definida como true, TransparentNetworkIPResolution será ignorada.

Se a Failover Partner chave estiver definida, TransparentNetworkIPResolution será ignorada.

O valor dessa chave deve ser true, false, yesou 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 padrão são os seguintes:

  • false Quando:

    • Conectando-se ao Banco de Dados SQL do Azure em que a fonte de dados termina com:

      • .database.chinacloudapi.cn
      • .database.usgovcloudapi.net
      • .database.cloudapi.de
      • .database.windows.net
    • Authentication é 'Senha do Active Directory' ou 'Active Directory Integrado'
  • true em todos os outros casos.
Confiar em Certificado do Servidor

-ou-

TrustServerCertificate
'false' Quando definido como true, o TLS é usado para criptografar o canal ao ignorar a movimentação da cadeia de certificados para validar a confiança. Se TrustServerCertificate estiver definido como true e Encrypt estiver definido como false, o canal não será criptografado. Os valores reconhecidos são true, false, yes e no. Para saber mais, confira Sintaxe de cadeia de conexão.
Digitar Versão do Sistema N/D Um valor de cadeia de caracteres que indica o sistema de tipos que o aplicativo espera. A funcionalidade disponível para um aplicativo cliente depende da versão do SQL Server e do nível de compatibilidade do banco de dados. Definir explicitamente a versão do sistema de tipos para o qual o aplicativo cliente foi escrito impede os possíveis problemas que podem fazer um aplicativo parar de funcionar se uma versão diferente do SQL Server for usada. Nota: A versão do sistema de tipos não pode ser definida para código CLR (Common Language Runtime) em execução em processo em SQL Server. Para obter mais informações, consulte 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 o aplicativo exigirá a versão 11.0.0.0 de Microsoft.SqlServer.Types.dll. As outras Type System Version configurações exigirão a versão 10.0.0.0 de Microsoft.SqlServer.Types.dll.

Latest está obsoleto e não deve ser usado. Latest é equivalente a Type System Version=SQL Server 2008;.
Id de Usuário

- ou -

UID

- ou -

Usuário
N/D A conta de logon SQL Server. Não recomendável. Para manter um alto nível de segurança, é altamente recomendável usar as Integrated Security palavras-chave ou Trusted_Connection . SqlCredentialé uma maneira mais segura de especificar credenciais para uma conexão que usa SQL Server Autenticação.

A ID do usuário deve ter 128 caracteres ou menos.
Instância do usuário 'false' Um valor que indica se a conexão deve ser redirecionada da instância de SQL Server Express padrão para uma instância iniciada por runtime em execução na conta do chamador.
ID da Estação de Trabalho

- ou -

WSID
O nome do computador local O nome da estação de trabalho que se conecta ao SQL Server.

A ID deve ter 128 caracteres ou menos.

A lista a seguir contém os nomes válidos para valores de pool de conexões dentro do ConnectionString. Para obter mais informações, consulte Pool de Conexões do SQL Server (ADO.NET).

  • Tempo de vida da conexão (ou tempo limite de balanceamento de carga)

  • Alistar

  • Tamanho Máx do Pool

  • Tamanho mínimo do pool

  • Agrupamento

Quando você estiver definindo palavra-chave ou valores de pool de conexões que exigem um valor booliano, você pode usar 'yes' em vez de 'true', e 'no' em vez de 'false'. Valores inteiros são representados como cadeias de caracteres.

Observação

O provedor de dados .NET Framework para SQL Server usa seu próprio protocolo para se comunicar com SQL Server. Portanto, ele não dá suporte ao uso de um DSN (nome de fonte de dados) ODBC ao se conectar a SQL Server porque não adiciona uma camada ODBC.

Observação

Não há suporte para arquivos UDL (link de dados universal) para o provedor de dados .NET Framework para SQL Server.

Cuidado

Nesta versão, o aplicativo deve ter cuidado ao construir um cadeia de conexão com base na entrada do usuário (por exemplo, ao recuperar informações de ID de usuário e senha de uma caixa de diálogo e acrescentá-lo ao cadeia de conexão). O aplicativo deve garantir que um usuário não possa inserir parâmetros de cadeia de conexão adicionais nesses valores (por exemplo, inserir uma senha como "validpassword; database=somedb" na tentativa de anexar a um banco de dados diferente). Se você precisar construir cadeias de conexão com base na entrada do usuário, use o novo SqlConnectionStringBuilder, que valida o cadeia de conexão e ajuda a eliminar esse problema. Consulte Construtores de Cadeia de Conexão para obter mais informações.

Aplica-se a