SqlConnection 생성자

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

오버로드

SqlConnection()	SqlConnection 클래스의 새 인스턴스를 초기화합니다.
SqlConnection(String)	연결 문자열을 포함한 문자열이 제공된 경우 SqlConnection 클래스의 새 인스턴스를 초기화합니다.
SqlConnection(String, SqlCredential)	연결 문자열이 지정되면 SqlConnection 클래스의 새 인스턴스를 초기화합니다. 연결 문자열은 사용자 ID와 암호를 포함하는 Integrated Security = true 및 SqlCredential 개체를 사용하지 않습니다.

SqlConnection()

SqlConnection 클래스의 새 인스턴스를 초기화합니다.

public:
 SqlConnection();

public SqlConnection ();

Public Sub New ()

예제

다음 예제에서는 를 만들고 엽니다 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;";
    }
}

설명

의 SqlConnection 새 인스턴스를 만들 때 읽기/쓰기 속성은 속성에서 연결된 키워드를 사용하여 특별히 설정되지 않는 한 다음 초기 값으로 설정됩니다 ConnectionString .

속성	초기 값
ConnectionString	빈 문자열("")
ConnectionTimeout	15
Database	빈 문자열("")
DataSource	빈 문자열("")

이러한 속성의 값은 속성을 사용해야 ConnectionString 만 변경할 수 있습니다. 클래스는 SqlConnectionStringBuilder 연결 문자열의 콘텐츠를 만들고 관리하기 위한 기능을 제공합니다.

SqlConnection(String)

연결 문자열을 포함한 문자열이 제공된 경우 SqlConnection 클래스의 새 인스턴스를 초기화합니다.

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)

매개 변수

connectionString

String

SQL Server 데이터베이스를 여는 데 사용되는 연결입니다.

예외

ArgumentException

제공된 연결 문자열 인수의 유효성 검사에 실패했습니다 ConnectionString .

예제

다음 예제에서는 를 만들고 엽니다 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;";
    }
}

설명

의 SqlConnection 새 인스턴스를 만들 때 읽기/쓰기 속성은 속성에서 연결된 키워드를 사용하여 특별히 설정되지 않는 한 다음 초기 값으로 설정됩니다 ConnectionString .

속성	초기 값
ConnectionString	connectionString
ConnectionTimeout	15
Database	빈 문자열("")
DataSource	빈 문자열("")

이러한 속성의 값은 속성을 사용해야 ConnectionString 만 변경할 수 있습니다. 클래스는 SqlConnection 연결 문자열의 콘텐츠를 만들고 관리하기 위한 기능을 제공합니다.

SqlConnection(String, SqlCredential)

연결 문자열이 지정되면 SqlConnection 클래스의 새 인스턴스를 초기화합니다. 연결 문자열은 사용자 ID와 암호를 포함하는 Integrated Security = true 및 SqlCredential 개체를 사용하지 않습니다.

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)

매개 변수

connectionString

String

연결 문자열 키워드 Integrated Security = true, UserId 또는 Password를 사용하지 않거나 ContextConnection = true를 사용하지 않는 연결 문자열입니다.

credential

SqlCredential

SqlCredential 개체입니다. credential이 null인 경우 SqlConnection(String, SqlCredential)은 SqlConnection(String)과 기능적으로 동일합니다.

예외

ArgumentException

제공된 인수는 유효성 검사를 포함하여 ConnectionString 유효성 검사에 실패했습니다.