DbConnectionStringBuilder.ConnectionString 속성

정의

네임스페이스:

System.Data.Common

어셈블리:

System.Data.Common.dll

Source:

DbConnectionStringBuilder.cs

DbConnectionStringBuilder와 연결된 연결 문자열을 가져오거나 설정합니다.

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

Public Property ConnectionString As String

속성 값

String

DbConnectionStringBuilder 내에 포함된 키/값 쌍에서 만든 현재 연결 문자열입니다. 기본값은 빈 문자열입니다.

예외

ArgumentException

잘못된 연결 문자열 인수가 제공되었습니다.

예제

다음 예제에서는 가능한 동작을 ConnectionString 보여 줍니다는 속성입니다. 예:

• 한 번에 하나씩 키/값 쌍을 빈 DbConnectionStringBuilder에 추가하여 연결 문자열 만듭니다.

• 전체 연결 문자열 instance ConnectionString 속성에 DbConnectionStringBuilder 할당하고 문자열 내에서 단일 키/값 쌍을 수정합니다.

• 속성에 임의의 키/값 쌍 ConnectionString 집합(즉, 연결 문자열 같이 원격으로 아무것도 아닌 문자열)을 할당하고 값 중 하나를 수정합니다.

• throw된 예외를 보여 주는 잘못된 연결 문자열 ConnectionString 속성에 할당합니다.

참고

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

static void Main()
{
    // Create a new DbConnctionStringBuilder, and add items
    // to the internal collection of key/value pairs.
    DbConnectionStringBuilder builder = new
        DbConnectionStringBuilder();
    builder.Add("Data Source", @"c:\MyData\MyDb.mdb");
    builder.Add("Provider", "Microsoft.Jet.Oledb.4.0");
    builder.Add("Jet OLEDB:Database Password", "********");
    builder.Add("Jet OLEDB:System Database",
        @"c:\MyData\Workgroup.mdb");

    // Set up row-level locking.
    builder.Add("Jet OLEDB:Database Locking Mode", 1);
    // Display the contents of the connection string, which
    // will now contain all the key/value pairs delimited with
    // semicolons.
    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();
    // Clear the DbConnectionStringBuilder, and assign a complete
    // connection string to it, to demonstrate how
    // the class parses connection strings.
    builder.Clear();
    builder.ConnectionString =
        "Data Source=(local);Initial Catalog=AdventureWorks;"
        + "Integrated Security=SSPI";
    // The DbConnectionStringBuilder class has parsed the contents,
    // so you can work with any individual key/value pair.
    builder["Data Source"] = ".";
    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();
    // Because the DbConnectionStringBuilder class doesn't
    // validate its key/value pairs, you can use this class
    // to store any semicolon-delimited list. The following
    // snippet places an arbitrary string into the ConnectionString
    // property, changes one of the values, and then displays the
    // resulting string.
    builder.Clear();
    builder.ConnectionString =
        "Value1=10;Value2=20;Value3=30;Value4=40";
    builder["Value2"] = 25;
    Console.WriteLine(builder.ConnectionString);
    Console.WriteLine();

    builder.Clear();
    try
    {
        // Assigning an invalid connection string
        // throws an ArgumentException.
        builder.ConnectionString = "xxx";
    }
    catch (ArgumentException)
    {
        Console.WriteLine("Invalid connection string.");
    }

    Console.WriteLine();
    Console.WriteLine("Press Enter to finish.");
    Console.ReadLine();
}

Sub Main()
    ' Create a new DbConnctionStringBuilder, and add items
    ' to the internal collection of key/value pairs.
    Dim builder As New DbConnectionStringBuilder()
    builder.Add("Data Source", "c:\MyData\MyDb.mdb")
    builder.Add("Provider", "Microsoft.Jet.Oledb.4.0")
    builder.Add("Jet OLEDB:Database Password", "*******")
    builder.Add("Jet OLEDB:System Database", _
        "c:\MyData\Workgroup.mdb")
    ' Set up row-level locking.
    builder.Add("Jet OLEDB:Database Locking Mode", 1)

    ' Display the contents of the connection string, which
    ' will now contain all the key/value pairs delimited with
    ' semicolons.
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    ' Clear the DbConnectionStringBuilder, and assign a complete
    ' connection string to it, to demonstrate how
    ' the class parses connection strings.
    builder.Clear()
    builder.ConnectionString = _
        "Data Source=(local);Initial Catalog=AdventureWorks;" & _
        "Integrated Security=SSPI"

    ' The DbConnectionStringBuilder class has parsed the contents, 
    ' so you can work with any individual key/value pair.
    builder("Data Source") = "."
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    ' Because the DbConnectionStringBuilder class doesn't 
    ' validate its key/value pairs, you can use this class
    ' to store any semicolon-delimited list. The following
    ' snippet places an arbitrary string into the ConnectionString
    ' property, changes one of the values, and then displays the
    ' resulting string.
    builder.Clear()
    builder.ConnectionString = _
        "Value1=10;Value2=20;Value3=30;Value4=40"
    builder("Value2") = 25
    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    builder.Clear()
    Try
        ' Assigning an invalid connection string
        ' throws an ArgumentException.
        builder.ConnectionString = "xxx"

    Catch ex As ArgumentException
        Console.WriteLine("Invalid connection string.")
    End Try

    Console.WriteLine()
    Console.WriteLine("Press Enter to finish.")
    Console.ReadLine()
End Sub

설명

이 속성은 에 의해 DbConnectionStringBuilder유지 관리되는 컬렉션 내에 저장된 키/값 쌍의 세미콜론으로 구분된 목록을 반환합니다. 각 쌍에는 등호로 구분된 키와 값이 포함됩니다. 다음 예제에서는 일반적인 연결 문자열 보여 줍니다.

"Persist Security Info=False;Integrated Security=SSPI;Initial Catalog=AdventureWorks;Data Source=(local)"

데이터 공급자는 각 연결 문자열 속성에 대해 특정 키와 값을 기대할 수 있습니다. , 이러한 값은 개별적으로 문서화됩니다. 클래스는 DbConnectionStringBuilder 해당 연결 문자열 연결된 키/값 쌍의 유효성을 검사하지 않지만 상속된 클래스는 유효성을 검사할 수 있습니다.

의 속성 DbConnectionStringBuilder 은 ConnectionString 일반적으로 동일한 기호로 구분된 키/값 쌍의 세미콜론으로 구분된 목록을 만들고 구문 분석하는 메커니즘으로 작동합니다. 연결 문자열과 관련된 유효성 검사 또는 기타 지원을 제공하지 않습니다. 컬렉션에 DbConnectionStringBuilder 항목을 추가하면 속성에 ConnectionString 변경 내용이 반영됩니다. 값을 할당 하는 ConnectionString 경우는 속성을 DbConnectionStringBuilder 세미콜론 및 등호 구분 기호를 사용 하 여 값을 구문 분석 하려고 합니다.

추가 정보

• ADO.NET의 연결 문자열
• ADO.NET 개요