SqlConnection Construtores

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

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.

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.

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

ArgumentException

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.

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

ArgumentException

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