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

Implementações

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.

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

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.
Nome do Aplicativo N/D O nome do aplicativo ou '.NET SQLClient Data Provider' se nenhum nome de aplicativo for fornecido.

Um nome de aplicativo pode ter 128 caracteres ou menos.
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.
Processamento assíncrono

- ou -

Async
'false' Quando true, habilita o suporte à operação assíncrona. Os valores reconhecidos são true, false, yes e no.

Essa propriedade é ignorada a partir do .NET Framework 4.5. Para obter mais informações sobre o suporte do SqlClient para programação assíncrona, consulte Programação assíncrona.
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=&#124;DataDirectory&#124;\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.
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 Integrado, Senha do Active Directory, Senha sql.
Configuração da criptografia de coluna N/D Habilita ou desabilita Always Encrypted funcionalidade para a conexão.
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.
Tempo de vida da conexão

- ou -

Tempo limite do balanceamento de carga
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.
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. O padrão é 1. 0 significa não tentar se reconectar (desabilitar a resiliência de conexão).

Para obter informações adicionais sobre resiliência de conexão, consulte Parâmetros do .NET SqlConnection para repetição de conexão e Artigo Técnico – Resiliência de Conexão Ociosa.
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; esta é a primeira tentativa de reconexão e só ocorrerá 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 as segundas e subsequentes tentativas de reconexão.

Para obter informações adicionais sobre resiliência de conexão, consulte Parâmetros do .NET SqlConnection para repetição de conexão e Artigo Técnico – Resiliência de Conexão Ociosa.
Conexão de contexto 'false' truese uma conexão em processo com SQL Server deve ser feita.
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 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)

A partir do .NET Framework 4.5, 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:nome> do< host\<nome da instância>
- 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 de 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, especificar um número de porta TCP/IP diretamente também é permitido. 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 de banco de dados à qual o aplicativo .NET Framework será conectado.

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: para o nome do servidor no cadeia de conexão ou usando localhost.
Encrypt 'false' Quando true, SQL Server usa a criptografia SSL para todos os dados enviados entre o cliente e o servidor se o servidor tiver um certificado instalado. Os valores reconhecidos são true, false, yes e no. Para saber mais, confira Sintaxe de cadeia de conexão.

A partir do .NET Framework 4.5, quando TrustServerCertificate é falso e Encrypt é true, o nome do servidor (ou endereço IP) em um certificado SSL SQL Server 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 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.
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).
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.
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).
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 definida como false ou no (altamente recomendada), as informações confidenciais de segurança, como a senha, não são retornadas como parte da conexão se a conexão estiver aberta ou nunca estiver em um estado aberto. 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.
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.
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, 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.
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.
TrustServerCertificate 'false' Quando definido como true, o SSL é 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

Confira também