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 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.

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.

Aplica-se a

Confira também

• Central de desenvolvedores de provedores gerenciados ADO.NET e DataSet
• 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