SqlConnectionStringBuilder 생성자

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

오버로드

SqlConnectionStringBuilder()	SqlConnectionStringBuilder 클래스의 새 인스턴스를 초기화합니다.
SqlConnectionStringBuilder(String)	SqlConnectionStringBuilder 클래스의 새 인스턴스를 초기화합니다. 제공된 연결 문자열에서는 인스턴스의 내부 연결 정보에 대한 데이터를 제공합니다.

SqlConnectionStringBuilder()

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

public:
 SqlConnectionStringBuilder();

public SqlConnectionStringBuilder ();

Public Sub New ()

SqlConnectionStringBuilder(String)

SqlConnectionStringBuilder 클래스의 새 인스턴스를 초기화합니다. 제공된 연결 문자열에서는 인스턴스의 내부 연결 정보에 대한 데이터를 제공합니다.

public:
 SqlConnectionStringBuilder(System::String ^ connectionString);

public SqlConnectionStringBuilder (string connectionString);

new Microsoft.Data.SqlClient.SqlConnectionStringBuilder : string -> Microsoft.Data.SqlClient.SqlConnectionStringBuilder

Public Sub New (connectionString As String)

매개 변수

connectionString

String

개체의 내부 연결 정보를 위한 기초로 사용됩니다. 이름/값 쌍으로 구문 분석됩니다. 키 이름이 잘못된 경우 KeyNotFoundException이 발생합니다.

예외

KeyNotFoundException

연결 문자열에 잘못된 키 이름이 포함된 경우

FormatException

연결 문자열에 잘못된 값이 포함된 경우(예: 부울 값이나 숫자 값이 필요하지만 제공되지 않은 경우)

ArgumentException

제공된 connectionString이 올바르지 않은 경우

예제

다음 예제에서는 SqlConnectionStringBuilder 개체의 생성자에서 간단한 SQL Server 연결 문자열을 제공한 다음 개체 내의 모든 키/값 쌍을 반복합니다. 컬렉션은 각 항목의 기본값을 제공합니다. 또한 SqlConnectionStringBuilder 클래스는 잘 알려진 키의 동의어를 잘 알려진 이름과 일치하도록 변환합니다.

참고

이 예제에는 SqlConnectionStringBuilder가 연결 문자열로 작업하는 방법을 보여 주기 위한 암호가 포함되어 있습니다. 애플리케이션에서는 Windows 인증을 사용하는 것이 좋습니다. 암호를 사용해야 하는 경우에는 애플리케이션에 하드 코드된 암호를 포함하지 마십시오.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Server=(local);Database=AdventureWorks;UID=ab;Pwd= a!Pass@@";
            Console.WriteLine("Original: " + connectString);
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Modified: " + builder.ConnectionString);
            foreach (string key in builder.Keys)
                Console.WriteLine(key + "=" + builder[key].ToString());
            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();

        }
        catch (System.Collections.Generic.KeyNotFoundException ex)
        {
            Console.WriteLine("KeyNotFoundException: " + ex.Message);
        }
        catch (System.FormatException ex)
        {
            Console.WriteLine("Format exception: " + ex.Message);
        }
    }
}

설명

SqlConnectionStringBuilder 클래스는 키/값 쌍의 고정된 내부 컬렉션을 제공합니다. 생성자에서 가능한 연결 문자열 값의 작은 하위 집합만 제공하는 경우에도 개체는 항상 각 키/값 쌍의 기본값을 제공합니다. 개체의 ConnectionString 속성을 검색할 때 문자열에는 값이 항목의 기본값이 아닌 키/값 쌍만 포함됩니다.