DbConnectionStringBuilder.Add(String, Object) 메서드

정의

네임스페이스:

System.Data.Common

어셈블리:

System.Data.Common.dll

Source:

DbConnectionStringBuilder.cs

지정한 키와 값을 가지는 엔트리를 DbConnectionStringBuilder에 추가합니다.

public:
 void Add(System::String ^ keyword, System::Object ^ value);

public void Add (string keyword, object value);

member this.Add : string * obj -> unit

Public Sub Add (keyword As String, value As Object)

매개 변수

keyword

String

DbConnectionStringBuilder에 추가할 키입니다.

value

Object

지정된 키의 값입니다.

예외

ArgumentNullException

keyword이 null 참조(Visual Basic의 경우 Nothing)인 경우

NotSupportedException

DbConnectionStringBuilder이 읽기 전용인 경우

또는

DbConnectionStringBuilder가 고정 크기입니다.

예제

다음 예제에서는 새 DbConnectionStringBuilder 를 만들고 항목을 추가합니다. 또한 이 코드는 메서드를 사용하여 Add 기존 항목을 덮어쓰는 방법을 보여 줍니다. 에는 을 throw하는 주석 처리된 블록이 포함되어 있습니다 ArgumentNullException.

참고

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

static void Main()
{
    try
    {
        DbConnectionStringBuilder builder =
            new DbConnectionStringBuilder();
        builder.Add("Data Source", "ServerName");
        builder.Add("Initial Catalog", "TheDatabase");
        builder.Add("User ID", "UserName");
        builder.Add("Password", "*******");
        builder.Add("Command Logging", false);

        // Overwrite the existing "User ID" value.
        builder.Add("User ID", "NewUserName");

        // The following code would trigger
        // an ArgumentNullException:
        // builder.Add(null, "Some Value");

        Console.WriteLine(builder.ConnectionString);
    }
    catch (ArgumentNullException)
    {
        Console.WriteLine("Null key values are not allowed.");
    }

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

Sub Main()
    Try
        Dim builder As New DbConnectionStringBuilder
        builder.Add("Data Source", "ServerName")
        builder.Add("Initial Catalog", "TheDatabase")
        builder.Add("User ID", "UserName")
        builder.Add("Password", "*******")
        builder.Add("Command Logging", False)

        ' Overwrite the existing "User ID" value.
        builder.Add("User ID", "NewUserName")

        ' The following code would trigger 
        ' an ArgumentNullException.
        ' builder.Add(Nothing, "Some Value")

        Console.WriteLine(builder.ConnectionString)

    Catch ex As ArgumentNullException
        Console.WriteLine("Null key values are not allowed.")
    End Try

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

설명

속성은 Item[] 사전에 없는 키의 값을 설정하여 새 요소를 추가하는 데 사용할 수도 있습니다. 예: myCollection["myNonexistentKey"] = myValue

Add null(NothingVisual Basic의 경우) 키를 전달하여 메서드를 호출하면 가 ArgumentNullExceptionthrow됩니다. 그러나 null 값을 전달하여 메서드를 호출 Add 하면 키/값 쌍이 제거됩니다.

추가 정보

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