SqlConnection.ConnectionString Propriedade

Definição

Obtém ou define a cadeia de caracteres usada para abrir um banco de dados do SQL Server.Gets or sets the string used to open a SQL Server database.

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
[System.ComponentModel.SettingsBindable(true)]
public string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
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.The connection string that includes the source database name, and other parameters needed to establish the initial connection. O valor padrão é uma cadeia de caracteres vazia.The default value is an empty string.

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.An invalid connection string argument has been supplied, or a required connection string argument has not been supplied.

Exemplos

O exemplo a seguir cria um SqlConnection e define a propriedade ConnectionString antes de abrir a conexão.The following example creates a SqlConnection and sets the ConnectionString property before opening the connection.

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 uma cadeia de conexão OLE DB, mas não é idêntico.The ConnectionString is similar to an OLE DB connection string, but is not identical. Ao contrário de OLE DB ou ADO, a cadeia de conexão retornada é a mesma que a ConnectionStringdo conjunto de usuários, menos informações de segurança se o valor de informações de segurança de persistência for definido como false (padrão).Unlike OLE DB or ADO, the connection string that is returned is the same as the user-set ConnectionString, minus security information if the Persist Security Info value is set to false (default). O Provedor de Dados .NET Framework para SQL Server não mantém ou retorna a senha em uma cadeia de conexão, a menos que você defina as informações de segurança de persistência como true.The .NET Framework Data Provider for SQL Server does not persist or return the password in a connection string unless you set Persist Security Info to true.

Você pode usar a propriedade ConnectionString para se conectar a um banco de dados.You can use the ConnectionString property to connect to a database. O exemplo a seguir ilustra uma cadeia de conexão típica.The following example illustrates a typical connection string.

"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.Use the new SqlConnectionStringBuilder to construct valid connection strings at run time. Para obter mais informações, confira Construtores de cadeias de conexão.For more information, see Connection String Builders.

A propriedade ConnectionString pode ser definida somente quando a conexão é fechada.The ConnectionString property can be set only when the connection is closed. Muitos dos valores de cadeia de conexão têm propriedades somente leitura correspondentes.Many of the connection string values have corresponding read-only properties. Quando a cadeia de conexão é definida, essas propriedades são atualizadas, exceto quando um erro é detectado.When the connection string is set, these properties are updated, except when an error is detected. Nesse caso, nenhuma das propriedades é atualizada.In this case, none of the properties are updated. SqlConnection Propriedades retornam apenas as configurações contidas no ConnectionString.SqlConnection properties return only those settings that are contained in the ConnectionString.

Para se conectar a um computador local, especifique "(local)" para o servidor.To connect to a local computer, specify "(local)" for the server. Se um nome de servidor não for especificado, será feita uma tentativa de conexão à instância padrão no computador local.If a server name is not specified, a connection will be attempted to the default instance on the local computer.

Redefinir o ConnectionString em uma conexão fechada redefine todos os valores de cadeia de conexão (e propriedades relacionadas), incluindo a senha.Resetting the ConnectionString on a closed connection resets all connection string values (and related properties) including the password. Por exemplo, se você definir uma cadeia de conexão que inclui "Database = AdventureWorks" e, em seguida, redefinir a cadeia de conexão para "Data Source = meuservidor; Integrated Security = true", a propriedade Database não será mais definida como "AdventureWorks".For example, if you set a connection string that includes "Database= AdventureWorks", and then reset the connection string to "Data Source=myserver;Integrated Security=true", the Database property is no longer set to "AdventureWorks".

A cadeia de conexão é analisada imediatamente após ser definida.The connection string is parsed immediately after being set. Se forem encontrados erros na sintaxe durante a análise, uma exceção de tempo de execução, como ArgumentException, será gerada.If errors in syntax are found when parsing, a runtime exception, such as ArgumentException, is generated. Outros erros podem ser encontrados somente quando é feita uma tentativa de abrir a conexão.Other errors can be found only when an attempt is made to open the connection.

O formato básico de uma cadeia de conexão inclui uma série de pares de palavras-chave/valor separados por ponto e vírgula.The basic format of a connection string includes a series of keyword/value pairs separated by semicolons. O sinal de igual (=) conecta cada palavra-chave e seu valor.The equal sign (=) connects each keyword and its value. Para incluir valores que contenham um ponto-e-vírgula, caractere de aspa simples ou caractere de aspas duplas, o valor deve ser colocado entre aspas duplas.To include values that contain a semicolon, single-quote character, or double-quote character, the value must be enclosed in double quotation marks. Se o valor contiver um ponto e vírgula e um caractere de aspas duplas, o valor poderá ser colocado entre aspas simples.If the value contains both a semicolon and a double-quote character, the value can be enclosed in single quotation marks. A aspa simples também será útil se o valor começar com um caractere de aspas duplas.The single quotation mark is also useful if the value starts with a double-quote character. Por outro lado, as aspas duplas podem ser usadas se o valor começar com uma aspa simples.Conversely, the double quotation mark can be used if the value starts with a single quotation mark. Se o valor contiver caracteres de aspas simples e aspas duplas, o caractere de aspas usado para colocar o valor deverá ser duplicado sempre que ocorrer dentro do valor.If the value contains both single-quote and double-quote characters, the quotation mark character used to enclose the value must be doubled every time it occurs within the value.

Para incluir espaços anteriores ou posteriores no valor da cadeia de caracteres, o valor deve ser colocado entre aspas simples ou aspas duplas.To include preceding or trailing spaces in the string value, the value must be enclosed in either single quotation marks or double quotation marks. Quaisquer espaços à esquerda ou à direita em relação a valores inteiros, boolianos ou enumerados são ignorados, mesmo se colocados entre aspas.Any leading or trailing spaces around integer, Boolean, or enumerated values are ignored, even if enclosed in quotation marks. No entanto, espaços em uma palavra-chave literal de cadeia de caracteres ou valor são preservados.However, spaces within a string literal keyword or value are preserved. Aspas simples ou duplas podem ser usadas em uma 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.Single or double quotation marks may be used within a connection string without using delimiters (for example, Data Source= my'Server or Data Source= my"Server), unless a quotation mark character is the first or last character in the value.

As palavras-chave não diferenciam maiúsculas de minúsculas.Keywords are not case sensitive.

A tabela a seguir lista os nomes válidos para valores de palavra-chave dentro do ConnectionString.The following table lists the valid names for keyword values within the ConnectionString.

Palavra-chaveKeyword PadrãoDefault DescriçãoDescription
AddrAddr {1>N/A<1}N/A Sinônimo da fonte de dados.Synonym of Data Source.
EndereçoAddress {1>N/A<1}N/A Sinônimo da fonte de dados.Synonym of Data Source.
AplicaçãoApp {1>N/A<1}N/A Sinônimo do nome do aplicativo.Synonym of Application Name.
Nome do aplicativoApplication Name {1>N/A<1}N/A O nome do aplicativo ou ' .NET SqlClient Provedor de Dados ' se nenhum nome de aplicativo for fornecido.The name of the application, or '.NET SQLClient Data Provider' if no application name is provided.

Um nome de aplicativo pode ter de 128 caracteres ou menos.An application name can be 128 characters or less.
ApplicationIntent ReadWrite Declara o tipo de carga de trabalho do aplicativo ao se conectar a um servidor.Declares the application workload type when connecting to a server. Os valores possíveis são ReadOnly e ReadWrite.Possible values are ReadOnly and ReadWrite. Por exemplo:For example:

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.For more information about SqlClient support for Always On Availability Groups, see SqlClient Support for High Availability, Disaster Recovery.
Processamento assíncronoAsynchronous Processing

- ou --or-

AsyncAsync
for'false' Quando true, o habilita o suporte à operação assíncrona.When true, enables asynchronous operation support. Os valores reconhecidos são true, false, yes e no.Recognized values are true, false, yes, and no.

Essa propriedade é ignorada do .NET Framework 4.5.NET Framework 4.5.This property is ignored beginning in .NET Framework 4.5.NET Framework 4.5. Para obter mais informações sobre o suporte a SqlClient para programação assíncrona, consulte programação assíncrona.For more information about SqlClient support for asynchronous programming, see Asynchronous Programming.
AttachDBFilenameAttachDBFilename

- ou --or-

Propriedades estendidasExtended Properties

- ou --or-

Nome de arquivo inicialInitial File Name
{1>N/A<1}N/A O nome do arquivo de banco de dados primário, incluindo o nome do caminho completo de um banco de dados anexável.The name of the primary database file, including the full path name of an attachable database. Só há suporte para AttachDBFilename para arquivos de dados primários com uma extensão. MDF.AttachDBFilename is only supported for primary data files with an .mdf extension.

Se o valor da chave AttachDBFileName for especificado na cadeia de conexão, o banco de dados será anexado e se tornará o banco de dados padrão para a conexão.If the value of the AttachDBFileName key is specified in the connection string, the database is attached and becomes the default database for the connection.

Se essa chave não for especificada e se o banco de dados tiver sido anexado anteriormente, o banco de dados não será anexado novamente.If this key is not specified and if the database was previously attached, the database will not be reattached. O banco de dados anexado anteriormente será usado como o banco de dados padrão para a conexão.The previously attached database will be used as the default database for the connection.

Se essa chave for especificada junto com a chave AttachDBFileName, o valor dessa chave será usado como o alias.If this key is specified together with the AttachDBFileName key, the value of this key will be used as the alias. No entanto, se o nome já estiver sendo usado em outro banco de dados anexado, a conexão falhará.However, if the name is already used in another attached database, the connection will fail.

O caminho pode ser absoluto ou relativo usando a cadeia de caracteres de substituição DataDirectory.The path may be absolute or relative by using the DataDirectory substitution string. Se o 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.If DataDirectory is used, the database file must exist within a subdirectory of the directory pointed to by the substitution string. Observação: Não há suporte para nomes de caminho de servidor remoto, HTTP e UNC.Note: Remote server, HTTP, and UNC path names are not supported.

O nome do banco de dados deve ser especificado com a palavra-chave ' database ' (ou um de seus aliases), como no seguinte:The database name must be specified with the keyword 'database' (or one of its aliases) as in the following:

"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 a palavra-chave ' database ' for usada ao anexar o arquivo de dados primário.An error will be generated if a log file exists in the same directory as the data file and the 'database' keyword is used when attaching the primary data file. Nesse caso, remova o arquivo de log.In this case, remove the log file. Depois que o banco de dados estiver anexado, um novo arquivo de log será gerado automaticamente com base no caminho físico.Once the database is attached, a new log file will be automatically generated based on the physical path.
AutenticaçãoAuthentication {1>N/A<1}N/A O método de autenticação usado para se conectar ao banco de dados SQL usando Azure Active Directory autenticação.The authentication method used for Connecting to SQL Database By Using Azure Active Directory Authentication.

Os valores válidos são:Valid values are:

Active Directory integrada, Active Directory senha, senha do SQL.Active Directory Integrated, Active Directory Password, Sql Password.
Configuração de criptografia de colunaColumn Encryption Setting {1>N/A<1}N/A Habilita ou desabilita a funcionalidade de Always Encrypted para a conexão.Enables or disables Always Encrypted functionality for the connection.
Tempo limite de conexãoConnect Timeout

- ou --or-

Tempo-limite da ConexãoConnection Timeout

- ou --or-

Tempo limiteTimeout
1515 O período de tempo (em segundos) para aguardar uma conexão com o servidor antes de encerrar a tentativa e gerar um erro.The length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error.

Os valores válidos são maior ou igual a 0 e menor ou igual a 2147483647.Valid values are greater than or equal to 0 and less than or equal to 2147483647.

Ao abrir uma conexão com um banco de dados SQL do Azure, defina o tempo limite da conexão como 30 segundos.When opening a connection to a Azure SQL Database, set the connection timeout to 30 seconds.
Tempo de vida da conexãoConnection Lifetime

- ou --or-

Tempo limite de balanceamento de cargaLoad Balance Timeout
00 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.When a connection is returned to the pool, its creation time is compared with the current time, and the connection is destroyed if that time span (in seconds) exceeds the value specified by 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.This is useful in clustered configurations to force load balancing between a running server and a server just brought online.

Um valor de zero (0) faz com que conexões em pool tenham o tempo limite máximo de conexão.A value of zero (0) causes pooled connections to have the maximum connection timeout.
ConnectRetryCountConnectRetryCount 11 Controla o número de tentativas de reconexão depois que o cliente identifica uma falha de conexão ociosa.Controls the number of reconnection attempts after the client identifies an idle connection failure. Os valores válidos são 0 a 255.Valid values are 0 to 255. O padrão é 1.The default is 1. 0 significa não tentar reconectar-se (desabilitar resiliência de conexão).0 means do not attempt to reconnect (disable connection resiliency).

Para obter informações adicionais sobre resiliência de conexão ociosa, consulte o artigo técnico – resiliência de conexão ociosa.For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
ConnectRetryIntervalConnectRetryInterval 1010 Especifica o tempo entre cada tentativa de repetição de conexão (ConnectRetryCount).Specifies the time between each connection retry attempt (ConnectRetryCount). Os valores válidos são de 1 a 60 segundos (padrão = 10), aplicados após a primeira tentativa de reconexão.Valid values are 1 to 60 seconds (default=10), applied after the first reconnection attempt. Quando uma conexão quebrada é detectada, o cliente tenta imediatamente se reconectar; Esta é a primeira tentativa de reconexão e só ocorre se ConnectRetryCount for maior que 0.When a broken connection is detected, the client immediately attempts to reconnect; this is the first reconnection attempt and only occurs if ConnectRetryCount is greater than 0. Se a primeira tentativa de reconexão falhar e ConnectRetryCount for maior que 1, o cliente aguardará ConnectRetryInterval para tentar a segunda e as tentativas de reconexão subsequentes.If the first reconnection attempt fails and ConnectRetryCount is greater than 1, the client waits ConnectRetryInterval to try the second and subsequent reconnection attempts.

Para obter informações adicionais sobre resiliência de conexão ociosa, consulte o artigo técnico – resiliência de conexão ociosa.For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
Conexão do contextoContext Connection for'false' true se uma conexão em processo com SQL Server deve ser feita.true if an in-process connection to SQL Server should be made.
Idioma atualCurrent Language

- ou --or-

LinguagemLanguage
{1>N/A<1}N/A Define o idioma usado para mensagens de aviso ou de erro do servidor de banco de dados.Sets the language used for database server warning or error messages.

O nome do idioma pode ter de 128 caracteres ou menos.The language name can be 128 characters or less.
Fonte de dadosData Source

- ou --or-

ServidorServer

- ou --or-

EndereçoAddress

- ou --or-

AddrAddr

- ou --or-

Endereço de redeNetwork Address
{1>N/A<1}N/A O nome ou endereço de rede da instância do SQL Server ao qual se conectar.The name or network address of the instance of SQL Server to which to connect. O número da porta pode ser especificado após o nome do servidor:The port number can be specified after the server name:

server=tcp:servername, portnumber

Ao especificar uma instância local, sempre use (local).When specifying a local instance, always use (local). Para forçar um protocolo, adicione um dos seguintes prefixos:To force a protocol, add one of the following prefixes:

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

A partir do .NET Framework 4.5.NET Framework 4.5, você também pode se conectar a um banco de dados LocalDB da seguinte maneira:Beginning in .NET Framework 4.5.NET Framework 4.5, you can also connect to a LocalDB database as follows:

server=(localdb)\\myInstance

Para obter mais informações sobre o LocalDB, consulte suporte a SqlClient para LocalDB.For more information about LocalDB, see SqlClient Support for LocalDB.

A fonte de dados deve usar o formato TCP ou o formato de pipes nomeados.Data Source must use the TCP format or the Named Pipes format.

O formato TCP é o seguinte:TCP format is as follows:

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

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.The TCP format must start with the prefix "tcp:" and is followed by the database instance, as specified by a host name and an instance name. Este formato não é aplicável ao se conectar ao banco de dados SQL do Azure.This format is not applicable when connecting to Azure SQL Database. O TCP é selecionado automaticamente para conexões com o banco de dados SQL do Azure quando nenhum protocolo é especificado.TCP is automatically selected for connections to Azure SQL Database when no protocol is specified.

O nome do host deve ser especificado de uma das seguintes maneiras:The host name MUST be specified in one of the following ways:

- NetBIOSName- NetBIOSName
-IPv4Address- IPv4Address
-IPv6Address- IPv6Address

O nome da instância é usado para resolver para um número de porta TCP/IP específico no qual uma instância de banco de dados está hospedada.The instance name is used to resolve to a particular TCP/IP port number on which a database instance is hosted. Como alternativa, a especificação direta de um número de porta TCP/IP também é permitida.Alternatively, specifying a TCP/IP port number directly is also allowed. Se o nome da instância e o número da porta não estiverem presentes, a instância do banco de dados padrão será usada.If both instance name and port number are not present, the default database instance is used.

O formato de pipes nomeados é o seguinte:The Named Pipes format is as follows:

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

O formato de pipes nomeados deve começar com o prefixo "np:" e é seguido por um nome de pipe nomeado.The Named Pipes format MUST start with the prefix "np:" and is followed by a named pipe name.

O nome do host deve ser especificado de uma das seguintes maneiras:The host name MUST be specified in one of the following ways:

- NetBIOSName- NetBIOSName
-IPv4Address- IPv4Address
-IPv6Address- IPv6Address

O nome do pipe é usado para identificar a instância do banco de dados à qual o aplicativo .NET Framework será conectado.The pipe name is used to identify the database instance to which the .NET Framework application will be connected.

Se o valor da chave de rede for especificado, os prefixos "TCP:" e "np:" não deverão ser especificados.If the value of the Network key is specified, the prefixes "tcp:" and "np:" should not be specified. Observação: Você pode forçar o uso de TCP em vez de memória compartilhada, seja prefixando TCP: para o nome do servidor na cadeia de conexão ou usando localhost.Note: You can force the use of TCP instead of shared memory, either by prefixing tcp: to the server name in the connection string, or by using localhost.
CriptografeEncrypt for'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.When true, SQL Server uses SSL encryption for all data sent between the client and server if the server has a certificate installed. Os valores reconhecidos são true, false, yes e no.Recognized values are true, false, yes, and no. Para obter mais informações, consulte sintaxe da cadeia de conexão.For more information, see Connection String Syntax.

A partir do .NET Framework 4.5.NET Framework 4.5, quando TrustServerCertificate é false 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 na cadeia de conexão.Beginning in .NET Framework 4.5.NET Framework 4.5, when TrustServerCertificate is false and Encrypt is true, the server name (or IP address) in a SQL Server SSL certificate must exactly match the server name (or IP address) specified in the connection string. Caso contrário, a tentativa de conexão falhará.Otherwise, the connection attempt will fail. Para obter informações sobre o suporte para certificados cujo assunto começa com um caractere curinga (*), consulte curingas aceitos usados por certificados de servidor para autenticação de servidor.For information about support for certificates whose subject starts with a wildcard character (*), see Accepted wildcards used by server certificates for server authentication.
GotaEnlist 'true''true' true indica que o pool de conexão do SQL Server automaticamente lista a conexão no contexto de transação atual do thread de criação.true indicates that the SQL Server connection pooler automatically enlists the connection in the creation thread's current transaction context.
Parceiro de FailoverFailover Partner {1>N/A<1}N/A O nome do servidor de parceiro de failover em que o espelhamento de banco de dados está configurado.The name of the failover partner server where database mirroring is configured.

Se o valor dessa chave for "", o catálogo inicial deverá estar presente e seu valor não deverá ser "".If the value of this key is "", then Initial Catalog must be present, and its value must not be "".

O nome do servidor pode ter de 128 ou menos caracteres.The server name can be 128 characters or less.

Se você especificar um parceiro de failover, mas o servidor de parceiro de failover não estiver configurado para espelhamento de banco de dados e o servidor primário (especificado com a palavra-chave Server) não estiver disponível, a conexão falhará.If you specify a failover partner but the failover partner server is not configured for database mirroring and the primary server (specified with the Server keyword) is not available, then the connection will fail.

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 (especificado com a palavra-chave Server) terá sucesso se o servidor primário estiver disponível.If you specify a failover partner and the primary server is not configured for database mirroring, the connection to the primary server (specified with the Server keyword) will succeed if the primary server is available.
Catálogo inicialInitial Catalog

- ou --or-

DatabaseDatabase
{1>N/A<1}N/A O nome do banco de dados.The name of the database.

O nome do banco de dados pode ter de 128 caracteres ou menos.The database name can be 128 characters or less.
Segurança integradaIntegrated Security

- ou --or-

Trusted_ConnectionTrusted_Connection
for'false' Quando false, a ID de usuário e a senha são especificadas na conexão.When false, User ID and Password are specified in the connection. Quando true, as credenciais atuais da conta do Windows são usadas para autenticação.When true, the current Windows account credentials are used for authentication.

Os valores reconhecidos são true, false, yes, noe sspi (altamente recomendado), que é equivalente a true.Recognized values are true, false, yes, no, and sspi (strongly recommended), which is equivalent to 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.If User ID and Password are specified and Integrated Security is set to true, the User ID and Password will be ignored and Integrated Security will be used.

SqlCredential é uma maneira mais segura de especificar credenciais para uma conexão que usa a autenticação SQL Server (Integrated Security=false).SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication (Integrated Security=false).
Tamanho Máx do PoolMax Pool Size 100100 O número máximo de conexões permitidas no pool.The maximum number of connections that are allowed in the pool.

Os valores válidos são maior ou igual a 1.Valid values are greater than or equal to 1. Os valores que são menores do que o tamanho do pool mínimo geram um erro.Values that are less than Min Pool Size generate an error.
Tamanho mínimo do poolMin Pool Size 00 O número mínimo de conexões permitidas no pool.The minimum number of connections that are allowed in the pool.

Os valores válidos são maior ou igual a 0.Valid values are greater than or equal to 0. Zero (0) neste campo significa que não há conexões mínimas abertas inicialmente.Zero (0) in this field means no minimum connections are initially opened.

Valores maiores que o tamanho máximo do pool geram um erro.Values that are greater than Max Pool Size generate an error.
MultipleActiveResultSetsMultipleActiveResultSets for'false' Quando true, um aplicativo pode manter MARS (vários conjuntos de resultados ativos).When true, an application can maintain multiple active result sets (MARS). Quando false, um aplicativo deve processar ou cancelar todos os conjuntos de resultados de um lote antes que ele possa executar qualquer outro lote nessa conexão.When false, an application must process or cancel all result sets from one batch before it can execute any other batch on that connection.

Os valores reconhecidos são true e false.Recognized values are true and false.

Para obter mais informações, confira MARS (Conjunto de Resultados Ativos Múltiplos).For more information, see Multiple Active Result Sets (MARS).
MultiSubnetFailover FALSEFALSE Sempre especifique multiSubnetFailover=True ao se conectar ao ouvinte do grupo de disponibilidade de um grupo de disponibilidade SQL Server 2012 (ou posterior) ou uma instância de cluster de failover do SQL Server 2012 (ou posterior).Always specify multiSubnetFailover=True when connecting to the availability group listener of a SQL Server 2012 (or later) availability group or a SQL Server 2012 (or later) Failover Cluster Instance. multiSubnetFailover=True configura o SqlClient para fornecer detecção mais rápida e conexão com o servidor ativo (atualmente).multiSubnetFailover=True configures SqlClient to provide faster detection of and connection to the (currently) active server. Os valores possíveis são Yes e No, True e False ou 1 e 0.Possible values are Yes and No, True and False or 1 and 0. Por exemplo:For example:

MultiSubnetFailover=True

O padrão é False.The default is False. Para obter mais informações sobre o suporte do SqlClient para Always On AGs, consulte suporte a SqlClient para alta disponibilidade e recuperação de desastre.For more information about SqlClient's support for Always On AGs, see SqlClient Support for High Availability, Disaster Recovery.
Biblioteca de redeNetwork Library

- ou --or-

RedeNetwork

- ou --or-

VirtualNet
{1>N/A<1}N/A A biblioteca de rede usada para estabelecer uma conexão com uma instância do SQL Server.The network library used to establish a connection to an instance of SQL Server. Os valores compatíveis incluem:Supported values include:

dbnmpntw (pipes nomeados)dbnmpntw (Named Pipes)

dbmsrpcn (multiprotocolo, RPC do Windows)dbmsrpcn (Multiprotocol, Windows RPC)

dbmsadsn (Apple Talk)dbmsadsn (Apple Talk)

dbmsgnet (VIA)dbmsgnet (VIA)

dbmslpcn (memória compartilhada)dbmslpcn (Shared Memory)

dbmsspxn (IPX/SPX)dbmsspxn (IPX/SPX)

dbmssocn (TCP/IP)dbmssocn (TCP/IP)

Dbmsvinn (Banyan Vines)Dbmsvinn (Banyan Vines)

A DLL de rede correspondente deve ser instalada no sistema ao qual você se conecta.The corresponding network DLL must be installed on the system to which you connect. Se você não especificar uma rede e usar um servidor local (por exemplo, "." ou "(local)"), a memória compartilhada será usada.If you do not specify a network and you use a local server (for example, "." or "(local)"), shared memory is used. Neste exemplo, a biblioteca de rede é Win32 Winsock TCP/IP (dbmssocn) e 1433 é a porta que está sendo usada.In this example, the network library is Win32 Winsock TCP/IP (dbmssocn), and 1433 is the port being used.

Network Library=dbmssocn;Data Source=000.000.000.000,1433;
Tamanho do PacotePacket Size 80008000 Tamanho em bytes dos pacotes de rede usados para se comunicar com uma instância do SQL Server.Size in bytes of the network packets used to communicate with an instance of SQL Server.

O tamanho do pacote pode ser maior ou igual a 512 e menor ou igual a 32768.The packet size can be greater than or equal to 512 and less than or equal to 32768.
SenhaPassword

- ou --or-

PWDPWD
{1>N/A<1}N/A A senha para a conta de SQL Server que faz logon.The password for the SQL Server account logging on. Não recomendado.Not recommended. Para manter um alto nível de segurança, é altamente recomendável usar a palavra-chave Integrated Security ou Trusted_Connection em vez disso.To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keyword instead. SqlCredential é uma maneira mais segura de especificar credenciais para uma conexão que usa a autenticação SQL Server.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

A senha deve ter de 128 caracteres ou menos.The password must be 128 characters or less.
Informação de persistência de segurançaPersist Security Info

- ou --or-

PersistSecurityInfoPersistSecurityInfo
for'false' Quando definido como false ou no (altamente recomendável), as informações sensíveis à segurança, como a senha, não são retornadas como parte da conexão se a conexão estiver aberta ou se já estiver em um estado aberto.When set to false or no (strongly recommended), security-sensitive information, such as the password, is not returned as part of the connection if the connection is open or has ever been in an open state. Redefinir a cadeia de conexão redefine todos os valores da cadeia de conexão, incluindo a senha.Resetting the connection string resets all connection string values including the password. Os valores reconhecidos são true, false, yes e no.Recognized values are true, false, yes, and no.
PoolBlockingPeriodPoolBlockingPeriod AutomáticoAuto Define o comportamento do período de bloqueio para um pool de conexões.Sets the blocking period behavior for a connection pool. Consulte PoolBlockingPeriod propriedade para obter detalhes.See PoolBlockingPeriod property for details.
AgrupamentoPooling 'true''true' Quando o valor dessa chave é definido como true, qualquer conexão recém-criada será adicionada ao pool quando fechada pelo aplicativo.When the value of this key is set to true, any newly created connection will be added to the pool when closed by the application. Na próxima tentativa de abrir a mesma conexão, essa conexão será extraída do pool.In a next attempt to open the same connection, that connection will be drawn from the pool.

As conexões são consideradas as mesmas se tiverem a mesma cadeia de conexão.Connections are considered the same if they have the same connection string. Conexões diferentes têm cadeias de conexão diferentes.Different connections have different connection strings.

O valor dessa chave pode ser "true", "false", "Yes" ou "no".The value of this key can be "true", "false", "yes", or "no".
ReplicaçãoReplication for'false' true se a replicação tem suporte usando a conexão.true if replication is supported using the connection.
Associação de transaçãoTransaction Binding Desassociar implícitoImplicit Unbind Controla a associação de conexão com uma transação de System.Transactions inscrito.Controls connection association with an enlisted System.Transactions transaction.

Os possíveis valores são:Possible values are:

Transaction Binding=Implicit Unbind;

Transaction Binding=Explicit Unbind;

A desassociação implícita faz com que a conexão seja desanexada da transação quando ela termina.Implicit Unbind causes the connection to detach from the transaction when it ends. Depois de desanexar, as solicitações adicionais na conexão são executadas no modo de confirmação automática.After detaching, additional requests on the connection are performed in autocommit mode. A propriedade System.Transactions.Transaction.Current não é verificada durante a execução de solicitações enquanto a transação está ativa.The System.Transactions.Transaction.Current property is not checked when executing requests while the transaction is active. Depois que a transação termina, as solicitações adicionais são executadas no modo de confirmação automática.After the transaction has ended, additional requests are performed in autocommit mode.

Se o sistema encerrar a transação (no escopo de um bloco Using) antes que o último comando seja concluído, ele emitirá InvalidOperationException.If the system ends the transaction (in the scope of a using block) before the last command completes, it will throw 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 SqlConnection.TransactionEnlist(null) explícito seja chamado.Explicit Unbind causes the connection to remain attached to the transaction until the connection is closed or an explicit SqlConnection.TransactionEnlist(null) is called. A partir do .NET Framework 4.NET Framework 4, as alterações no desligamento implícito tornam obsoletas explícitas desligadas.Beginning in .NET Framework 4.NET Framework 4, changes to Implicit Unbind make Explicit Unbind obsolete. Um InvalidOperationException será gerado se Transaction.Current não for a transação inlistada ou se a transação enlistada não estiver ativa.An InvalidOperationException is thrown if Transaction.Current is not the enlisted transaction or if the enlisted transaction is not active.
TransparentNetworkIPResolutionTransparentNetworkIPResolution Consulte a descrição.See description. 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.When the value of this key is set to true, the application is required to retrieve all IP addresses for a particular DNS entry and attempt to connect with the first one in the list. Se a conexão não for estabelecida em 0,5 segundos, o aplicativo tentará se conectar a todos os outros paralelamente.If the connection is not established within 0.5 seconds, the application will try to connect to all others in parallel. Quando o primeiro responder, o aplicativo estabelecerá a conexão com o endereço IP do respondedor.When the first answers, the application will establish the connection with the respondent IP address.

Se a chave de MultiSubnetFailover for definida como true, TransparentNetworkIPResolution será ignorado.If the MultiSubnetFailover key is set to true, TransparentNetworkIPResolution is ignored.

Se a chave de Failover Partner for definida, TransparentNetworkIPResolution será ignorado.If the Failover Partner key is set, TransparentNetworkIPResolution is ignored.

O valor dessa chave deve ser true, false, yesou no.The value of this key must be true, false, yes, or no.

Um valor de yes é tratado da mesma forma que um valor de true.A value of yes is treated the same as a value of true.

Um valor de no é tratado da mesma forma que um valor de false.A value of no is treated the same as a value of false.

Os valores padrão são os seguintes:The default values are as follows:

  • false quando:false when:

    • Conectando-se ao banco de dados SQL do Azure em que a fonte é encerrada:Connecting to Azure SQL Database where the data source ends with:

      • .database.chinacloudapi.cn.database.chinacloudapi.cn
      • .database.usgovcloudapi.net.database.usgovcloudapi.net
      • .database.cloudapi.de.database.cloudapi.de
      • .database.windows.net.database.windows.net
    • Authentication é ' Active Directory senha ' ou ' Active Directory integrado 'Authentication is 'Active Directory Password' or 'Active Directory Integrated'
  • true em todos os outros casos.true in all other cases.
TrustServerCertificateTrustServerCertificate for'false' Quando definido como true, o SSL é usado para criptografar o canal ao ignorar a cadeia de certificados para validar a confiança.When set to true, SSL is used to encrypt the channel when bypassing walking the certificate chain to validate trust. Se TrustServerCertificate for definido como true e encrypt estiver definido como false, o canal não será criptografado.If TrustServerCertificate is set to true and Encrypt is set to false, the channel is not encrypted. Os valores reconhecidos são true, false, yes e no.Recognized values are true, false, yes, and no. Para obter mais informações, consulte sintaxe da cadeia de conexão.For more information, see Connection String Syntax.
Versão do sistema de tiposType System Version {1>N/A<1}N/A Um valor de cadeia de caracteres que indica o sistema de tipos esperado pelo aplicativo.A string value that indicates the type system the application expects. 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.The functionality available to a client application is dependent on the version of SQL Server and the compatibility level of the database. 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.Explicitly setting the type system version that the client application was written for avoids potential problems that could cause an application to break if a different version of SQL Server is used. Observação: A versão do sistema de tipos não pode ser definida para o código Common Language Runtime (CLR) em execução no processo no SQL Server.Note: The type system version cannot be set for common language runtime (CLR) code executing in-process in SQL Server. Para obter mais informações, consulte SQL Server a integração Common Language Runtime.For more information, see SQL Server Common Language Runtime Integration.

Os possíveis valores são:Possible values are:

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 precisará da versão 11.0.0.0 do Microsoft. SqlServer. Types. dll.Type System Version=SQL Server 2012; specifies that the application will require version 11.0.0.0 of Microsoft.SqlServer.Types.dll. As outras configurações de Type System Version exigirão a versão 10.0.0.0 de Microsoft. SqlServer. Types. dll.The other Type System Version settings will require version 10.0.0.0 of Microsoft.SqlServer.Types.dll.

Latest é obsoleto e não deve ser usado.Latest is obsolete and should not be used. Latest equivale a Type System Version=SQL Server 2008;.Latest is equivalent to Type System Version=SQL Server 2008;.
ID de usuárioUser ID

- ou --or-

UIDUID

- ou --or-
{1>N/A<1}N/A A conta de logon do SQL Server.The SQL Server login account. Não recomendado.Not recommended. Para manter um alto nível de segurança, é altamente recomendável usar as palavras-chave Integrated Security ou Trusted_Connection.To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keywords instead. SqlCredential é uma maneira mais segura de especificar credenciais para uma conexão que usa a autenticação SQL Server.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

A ID de usuário deve ter de 128 caracteres ou menos.The user ID must be 128 characters or less.
Instância do usuárioUser Instance for'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 pelo Runtime em execução na conta do chamador.A value that indicates whether to redirect the connection from the default SQL Server Express instance to a runtime-initiated instance running under the account of the caller.
ID da estação de trabalhoWorkstation ID

- ou --or-

WSIDWSID
O nome do computador localThe local computer name O nome da estação de trabalho que se conecta a SQL Server.The name of the workstation connecting to SQL Server.

A ID deve ter 128 caracteres ou menos.The ID must be 128 characters or less.

A lista a seguir contém os nomes válidos para os valores de pool de conexões dentro do ConnectionString.The following list contains the valid names for connection pooling values within the ConnectionString. Para obter mais informações, confira Pooling de conexão do SQL Server (ADO.NET).For more information, see SQL Server Connection Pooling (ADO.NET).

  • Vida útil da conexão (ou tempo limite de balanceamento de carga)Connection Lifetime (or Load Balance Timeout)

  • GotaEnlist

  • Tamanho Máx do PoolMax Pool Size

  • Tamanho mínimo do poolMin Pool Size

  • AgrupamentoPooling

Ao definir a palavra-chave ou os 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 '.When you are setting keyword or connection pooling values that require a Boolean value, you can use 'yes' instead of 'true', and 'no' instead of 'false'. Os valores inteiros são representados como cadeias de caracteres.Integer values are represented as strings.

Observação

O Provedor de Dados .NET Framework para SQL Server usa seu próprio protocolo para se comunicar com SQL Server.The .NET Framework Data Provider for SQL Server uses its own protocol to communicate with SQL Server. Portanto, ele não dá suporte ao uso de um nome de fonte de dados ODBC (DSN) ao se conectar a SQL Server porque ele não adiciona uma camada ODBC.Therefore, it does not support the use of an ODBC data source name (DSN) when connecting to SQL Server because it does not add an ODBC layer.

Observação

Não há suporte para arquivos UDL (Universal Data Link) para o .NET Framework Provedor de Dados para SQL Server.Universal data link (UDL) files are not supported for the .NET Framework Data Provider for SQL Server.

Cuidado

Nesta versão, o aplicativo deve ter cuidado ao construir uma 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 anexá-la à cadeia de conexão).In this release, the application should use caution when constructing a connection string based on user input (for example when retrieving user ID and password information from a dialog box, and appending it to the connection string). O aplicativo deve garantir que um usuário não possa inserir parâmetros de cadeia de conexão adicionais nesses valores (por exemplo, inserindo uma senha como "validpassword; Database = somedb" em uma tentativa de anexar a um banco de dados diferente).The application should make sure that a user cannot embed additional connection string parameters in these values (for example, entering a password as "validpassword;database=somedb" in an attempt to attach to a different database). Se você precisar construir cadeias de conexão com base na entrada do usuário, use o novo SqlConnectionStringBuilder, que valida a cadeia de conexão e ajuda a eliminar esse problema.If you need to construct connection strings based on user input, use the new SqlConnectionStringBuilder, which validates the connection string and helps to eliminate this problem. Consulte construtores de cadeia de conexão para obter mais informações.See Connection String Builders for more information.

Aplica-se a

Veja também