Idioma

SqlConnection Construtores

Definição

Sobrecargas

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

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    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;";
    }
}

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.

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 Microsoft.Data.SqlClient.SqlConnection : string -> Microsoft.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

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

Exemplos

O exemplo a seguir cria e abre um SqlConnection.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    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;";
    }
}

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.

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, Microsoft::Data::SqlClient::SqlCredential ^ credential);
public SqlConnection (string connectionString, Microsoft.Data.SqlClient.SqlCredential credential);
new Microsoft.Data.SqlClient.SqlConnection : string * Microsoft.Data.SqlClient.SqlCredential -> Microsoft.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

Os argumentos fornecidos falharam na validação, incluindo ConnectionString a validação.

Aplica-se a