SqlConnection Construtores

Definição

Namespace:

System.Data.SqlClient

Assembly:

System.Data.dll

Inicializa uma nova instância da classe SqlConnection.

Sobrecargas

SqlConnection()	Inicializa uma nova instância da classe SqlConnection.
SqlConnection(String)	Inicializa uma nova instância da classe SqlConnection quando recebe uma cadeia de caracteres que contém a cadeia de conexão.
SqlConnection(String, SqlCredential)	Inicializa uma nova instância da classe SqlConnection que recebeu uma cadeia de conexão, que não usa Integrated Security = true e um objeto SqlCredential que contém a ID de usuário e senha.

SqlConnection()

Inicializa uma nova instância da classe SqlConnection.

public:
 SqlConnection();

public SqlConnection ();

Public Sub New ()

Exemplos

O exemplo a seguir cria e abre um SqlConnection.

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
        Console.WriteLine("State: {0}", connection.State);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code,
    // you can retrieve it from a configuration file, using the
    // System.Configuration.ConfigurationManager.ConnectionStrings property
    return "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI;";
}

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("State: {0}", connection.State)
    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, using the
    ' System.Configuration.ConfigurationManager.ConnectionStrings property
    Return "Data Source=(local);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function

Comentários

Quando uma nova instância de é criada, as propriedades de SqlConnection leitura/gravação são definidas com os valores iniciais a seguir, a menos que sejam definidas especificamente usando suas palavras-chave associadas na ConnectionString propriedade .

Propriedades	Valor inicial
ConnectionString	cadeia de caracteres vazia ("")
ConnectionTimeout	15
Database	cadeia de caracteres vazia ("")
DataSource	cadeia de caracteres vazia ("")

Você pode alterar o valor dessas propriedades apenas usando a ConnectionString propriedade . A SqlConnectionStringBuilder classe fornece funcionalidade para criar e gerenciar o conteúdo das cadeias de conexão.

Confira também

• Conectando-se a uma fonte de dados no ADO.NET
• SQL Server e ADO.NET
• Visão geral do ADO.NET

SqlConnection(String)

Inicializa uma nova instância da classe SqlConnection quando recebe uma cadeia de caracteres que contém a cadeia de conexão.

public:
 SqlConnection(System::String ^ connectionString);

public SqlConnection (string connectionString);

new System.Data.SqlClient.SqlConnection : string -> System.Data.SqlClient.SqlConnection

Public Sub New (connectionString As String)

Parâmetros

connectionString

String

A conexão usada para abrir o banco de dados do SQL Server.

Exceções

ArgumentException

Falha na validação do argumento ConnectionString cadeia de conexão fornecido.

Exemplos

O exemplo a seguir cria e abre um SqlConnection.

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();

    using (SqlConnection connection = new SqlConnection(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, using the
    // System.Configuration.ConfigurationSettings.AppSettings property
    return "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI;";
}

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection(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, using the
    ' System.Configuration.ConfigurationSettings.AppSettings property
    Return "Data Source=(local);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function

Comentários

Quando uma nova instância de é criada, as propriedades de SqlConnection leitura/gravação são definidas com os valores iniciais a seguir, a menos que sejam definidas especificamente usando suas palavras-chave associadas na ConnectionString propriedade .

Propriedades	Valor inicial
ConnectionString	connectionString
ConnectionTimeout	15
Database	cadeia de caracteres vazia ("")
DataSource	cadeia de caracteres vazia ("")

Você pode alterar o valor dessas propriedades apenas usando a ConnectionString propriedade . A SqlConnection classe fornece funcionalidade para criar e gerenciar o conteúdo das cadeias de conexão.

Confira também

• Conectando-se a uma fonte de dados (ADO.NET)
• Usando o provedor de dados .NET Framework para SQL Server
• Visão geral do ADO.NET

SqlConnection(String, SqlCredential)

Inicializa uma nova instância da classe SqlConnection que recebeu uma cadeia de conexão, que não usa Integrated Security = true e um objeto SqlCredential que contém a ID de usuário e senha.

public:
 SqlConnection(System::String ^ connectionString, System::Data::SqlClient::SqlCredential ^ credential);

public SqlConnection (string connectionString, System.Data.SqlClient.SqlCredential credential);

new System.Data.SqlClient.SqlConnection : string * System.Data.SqlClient.SqlCredential -> System.Data.SqlClient.SqlConnection

Public Sub New (connectionString As String, credential As SqlCredential)

Parâmetros

connectionString

String

Uma cadeia de conexão que não usa nenhuma das seguintes palavras-chave da cadeia de conexão: Integrated Security = true, UserId ou Password; ou que não usa ContextConnection = true.

credential

SqlCredential

Um objeto SqlCredential. Se credential for nulo, SqlConnection(String, SqlCredential) será funcionalmente equivalente ao SqlConnection(String).

Exceções

ArgumentException

Falha na validação do argumento ConnectionString cadeia de conexão fornecido.

Confira também

• Visão geral do ADO.NET