SqlConnection.ConnectionString Propriedade

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

DataSysDescriptionAttribute SettingsBindableAttribute

Exceções

Exemplos

O exemplo a seguir cria uma SqlConnection propriedade 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 uma cadeia de conexão OLE DB, mas não é idêntico. Ao contrário do OLE DB ou do ADO, a cadeia de conexão retornada é a mesma que o conjunto ConnectionStringde usuários, menos informações de segurança se o valor de Informações de Segurança Persistente estiver definido false como (padrão). O Provedor de Dados do .NET Framework para SQL Server não persiste ou retorna a senha em uma cadeia de conexão, a menos que você defina Persist Security Info como true.

Você pode usar a ConnectionString propriedade para se conectar a um banco de dados. O exemplo a seguir ilustra uma cadeia de conexão típica.

"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 a cadeia de conexão é definida, 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 para a instância padrão no computador local.

Redefinir a ConnectionString conexão 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 uma cadeia de conexão que inclua "Database= AdventureWorks" e redefinir a cadeia de conexão como "Data Source=myserver; Integrated Security=true", a Database propriedade não está mais definida como "AdventureWorks".

A cadeia de conexão é analisada imediatamente após ser definida. 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 ponto-e-vírgula, caractere de aspa única ou 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 aspa única e de 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 uma palavra-chave ou valor literal de cadeia de caracteres são preservados. Aspas simples ou duplas podem ser usadas em uma cadeia de conexão sem usar delimitadores (por exemplo, Data Source= my'Server ou Data Source= my"Server), 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 de palavra-chave dentro do ConnectionString.

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 SQL Server Connection Pooling (ADO.NET).

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

Ao definir valores de pool de conexões ou palavras-chave 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.

Confira também

• ADO.NET Provedores Gerenciados e DataSet Developer Center
• Cadeias de conexão no ADO.NET
• Pool de Conexões do SQL Server (ADO.NET)
• Conectando-se a uma fonte de dados no ADO.NET
• Visão geral do ADO.NET