SqlConnectionStringBuilder.Remove(String) 메서드

정의

네임스페이스:

System.Data.SqlClient

어셈블리:

System.Data.SqlClient.dll

패키지:

System.Data.SqlClient v4.9.0

Source:

System.Data.SqlClient.notsupported.cs

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)

예제

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

경고

안전하지 않은 패턴이므로 사용자 이름과 암호를 직접 제공하지 않는 것이 좋습니다. 가능한 경우Azure 리소스에 대한 관리 ID 또는 SQL Server용 Windows 인증 같은 보다 안전한 인증 흐름을 사용합니다.

using System.Data.SqlClient;

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

            SqlConnectionStringBuilder builder = new(connectString);
            Console.WriteLine($"Original: {builder.ConnectionString}");

            // Remove the User ID and Password.
            builder.Remove("User ID");
            builder.Remove("Password");

            // Enable integrated security.
            builder.IntegratedSecurity = true;

            Console.WriteLine($"Modified: {builder.ConnectionString}");
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}
/* This code example produces the following output:
 * Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password=myPassw0rd
 * Modified: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True
 */

    Dim connectString As String =
     "Data Source=(local);User ID=ab;Password=a1Pass@@11;" &
     "Initial Catalog=AdventureWorks"

    Dim builder As New SqlConnectionStringBuilder(connectString)
    Console.WriteLine("Original: " & builder.ConnectionString)

    ' Remove the user ID and password.
    builder.Remove("User ID")
    builder.Remove("Password")

    ' Turn on integrated security:
    builder.IntegratedSecurity = True

    Console.WriteLine("Modified: " & builder.ConnectionString)

Catch ex As Exception
    Console.WriteLine(ex.Message)
End Try

' This code produces the following output:
' Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password=a1Pass@@11
' Modified: Data Source = (local);Initial Catalog=AdventureWorks;Integrated Security=True

설명

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

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

열쇠	기본값
애플리케이션 이름	".Net SqlClient 데이터 공급자"
비동기 처리	False
AttachDBFilename	빈 문자열
연결 시간 제한	15
컨텍스트 연결	False
현재 언어	빈 문자열
데이터 원본	빈 문자열
암호화하다	False
입대하다	참
장애 조치(failover) 파트너	빈 문자열
초기 카탈로그	빈 문자열
통합 보안	False
부하 분산 시간 제한	0
최대 풀 크기	100
최소 풀 크기	0
MultipleActiveResultSets	False
네트워크 라이브러리	빈 문자열
패킷 크기	8000
암호	빈 문자열
보안 정보 유지	False
풀링	참
복제	False
트랜잭션 바인딩	암시적 바인딩 해제
사용자 ID	빈 문자열
사용자 인스턴스	False
워크스테이션 ID	빈 문자열

추가 정보

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