SqlConnection Construtores

Definição

Espaço de Nomes:
System.Data.SqlClient
Assemblagem:
System.Data.dll

Inicializa uma nova instância da SqlConnection classe.

Sobrecargas

Name Description
SqlConnection()

Inicializa uma nova instância da SqlConnection classe.
SqlConnection(String)

Inicializa uma nova instância da classe SqlConnection quando recebe uma cadeia que contém a cadeia de ligação.
SqlConnection(String, SqlCredential)

Inicializa uma nova instância da classe SqlConnection dada uma cadeia de ligação, que não utiliza Integrated Security = true e um objeto SqlCredential que contém o ID de utilizador e a palavra-passe.

SqlConnection()

Inicializa uma nova instância da SqlConnection classe.

public:
 SqlConnection();
public SqlConnection();
Public Sub New ()

Exemplos

O exemplo seguinte 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

Observações

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

Properties Valor inicial
ConnectionString corda vazia ("")
ConnectionTimeout 15
Database corda vazia ("")
DataSource corda vazia ("")

Só pode alterar o valor dessas propriedades usando a ConnectionString propriedade. A SqlConnectionStringBuilder classe fornece funcionalidades para criar e gerir o conteúdo das cadeias de ligação.

Ver também

Aplica-se a

SqlConnection(String)

Inicializa uma nova instância da classe SqlConnection quando recebe uma cadeia que contém a cadeia de ligaçã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 ligação era usada para abrir a base de dados do SQL Server.

Exceções

ArgumentException

O argumento cadeia de ligação fornecido falhou ConnectionString validação.

Exemplos

O exemplo seguinte 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

Observações

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

Properties Valor inicial
ConnectionString connectionString
ConnectionTimeout 15
Database corda vazia ("")
DataSource corda vazia ("")

Só pode alterar o valor dessas propriedades usando a ConnectionString propriedade. A SqlConnection classe fornece funcionalidades para criar e gerir o conteúdo das cadeias de ligação.

Ver também

Aplica-se a

SqlConnection(String, SqlCredential)

Inicializa uma nova instância da classe SqlConnection dada uma cadeia de ligação, que não utiliza Integrated Security = true e um objeto SqlCredential que contém o ID de utilizador e a palavra-passe.

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

Um cadeia de ligação que não utiliza nenhuma das seguintes palavras-chave cadeia de ligação: Integrated Security = true, UserId ou Password; ou que não utiliza ContextConnection = true.

credential
SqlCredential

Um objeto SqlCredential. Se credential é nulo, SqlConnection(String, SqlCredential) é funcionalmente equivalente a SqlConnection(String).

Exceções

ArgumentException

O argumento cadeia de ligação fornecido falhou ConnectionString validação.

Ver também

Aplica-se a