Partilhar via


SqlConnection Construtores

Definição

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

Aplica-se a

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

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

Aplica-se a

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

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

Confira também

Aplica-se a