SqlConnectionStringBuilder.Remove(String) 메서드

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

지정된 키를 가진 항목을 SqlConnectionStringBuilder 인스턴스에서 제거합니다.

public:
 override bool Remove(System::String ^ keyword);

public override bool Remove (string keyword);

override this.Remove : string -> bool

Public Overrides Function Remove (keyword As String) As Boolean

매개 변수

keyword

String

이 SqlConnectionStringBuilder의 연결 문자열에서 제거할 키/값 쌍의 키입니다.

반환

Boolean

연결 문자열에 키가 존재하여 이를 제거했으면 true이고, 키가 존재하지 않으면 false입니다.

예외

ArgumentNullException

keyword가 null(Visual Basic에서는 Nothing)입니다.

예제

다음 예제에서는 기존 연결 문자열을 Windows 인증 사용에서 통합 보안 사용으로 변환합니다. 이 예제에서는 연결 문자열에서 사용자 이름과 암호를 제거한 다음 IntegratedSecurity 개체의 SqlConnectionStringBuilder 속성을 설정하여 이 작업을 수행합니다.

참고

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

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=(local);User ID=ab;Password= a1Pass@@11;" +
                "Initial Catalog=AdventureWorks";

            SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);

            // Use the Remove method
            // in order to reset the user ID and password back to their
            // default (empty string) values. 
            builder.Remove("User ID");
            builder.Remove("Password");

            // Turn on integrated security:
            builder.IntegratedSecurity = true;

            Console.WriteLine("Modified: " + builder.ConnectionString);

            using (SqlConnection
                       connection = new SqlConnection(builder.ConnectionString))
            {
                connection.Open();
                // Now use the open connection.
                Console.WriteLine("Database = " + connection.Database);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }

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

이 예제에서는 콘솔 창에 다음 텍스트를 표시합니다.

Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password= a1Pass@@11  
Modified: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True  
Database = AdventureWorks  

설명

Remove 메서드는 성공을 나타내는 값을 반환하므로 인스턴스에서 SqlConnectionStringBuilder 키/값 쌍을 제거하기 전에 키를 찾을 필요가 없습니다. SqlConnectionStringBuilder는 고정 크기의 키/값 쌍 컬렉션을 유지하기 때문에 Remove 메서드를 호출하면 키/값 쌍의 값이 기본값으로 다시 설정됩니다.

SqlConnectionStringBuilder가 지원하는 키 컬렉션이 고정되어 있기 때문에 컬렉션 내의 모든 항목에는 알려진 기본값이 있습니다. 다음 표에는 키와 SqlConnectionStringBuilder가 처음 초기화되었을 때나 Remove 메서드가 호출된 후의 각 키 값이 나열되어 있습니다.

키	기본값
애플리케이션 이름	.NET Framework 실행할 때 "Framework Microsoft SqlClient 데이터 공급자" 그렇지 않으면 "핵심 Microsoft SqlClient 데이터 공급자"입니다.
AttachDBFilename	빈 문자열
연결 제한 시간	15
컨텍스트 연결(사용되지 않음)	거짓
현재 언어	빈 문자열
데이터 원본	빈 문자열
Encrypt	4.0 이전 버전의 False, 버전 4.0 이상에서 True
Enlist	참
장애 조치(failover) 파트너	빈 문자열
초기 카탈로그	빈 문자열
Integrated Security	거짓
Load Balance Timeout	0
Max Pool Size	100
Min Pool Size	0
MultipleActiveResultSets	거짓
Network Library	빈 문자열
패킷 크기	8000
암호	빈 문자열
보안 정보 유지	거짓
Pooling	참
복제	거짓
트랜잭션 바인딩	Implicit Unbind
사용자 ID	빈 문자열
User Instance	거짓
워크스테이션 ID	빈 문자열