DbConnectionStringBuilder.Remove(String) 메서드

정의

네임스페이스:

System.Data.Common

어셈블리:

System.Data.Common.dll

Source:

DbConnectionStringBuilder.cs

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

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

public virtual bool Remove (string keyword);

abstract member Remove : string -> bool
override this.Remove : string -> bool

Public Overridable Function Remove (keyword As String) As Boolean

매개 변수

keyword

String

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

반환

Boolean

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

예외

ArgumentNullException

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

NotSupportedException

DbConnectionStringBuilder 가 읽기 전용이거나 DbConnectionStringBuilder 가 고정된 크기입니다.

예제

static void Main()
{
    DbConnectionStringBuilder builder = new
        DbConnectionStringBuilder();
    builder.ConnectionString =
        @"Provider=Microsoft.Jet.OLEDB.4.0;Data
            Source=C:\Demo.mdb;" +
        "Jet OLEDB:System Database=system.mdw;";

    // Try to remove an existing item.
    TryRemove(builder, "Provider");

    // Try to remove a nonexistent item.
    TryRemove(builder, "User ID");

    // Try to remove an existing item,
    // demonstrating that the search isn't
    // case sensitive.
    TryRemove(builder, "DATA SOURCE");
    Console.ReadLine();
}

static void TryRemove(DbConnectionStringBuilder builder, string itemToRemove)
{
    if (builder.Remove(itemToRemove))
    {
        Console.WriteLine(@"Removed '{0}'", itemToRemove);
    }
    else
    {
        Console.WriteLine(@"Unable to remove '{0}'", itemToRemove);
    }
    Console.WriteLine(builder.ConnectionString);
}

Sub Main()
    Dim builder As New DbConnectionStringBuilder
    builder.ConnectionString = _
        "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Demo.mdb;" & _
        "Jet OLEDB:System Database=system.mdw;"

    ' Try to remove an existing item.
    TryRemove(builder, "Provider")

    ' Try to remove a nonexistent item.
    TryRemove(builder, "User ID")

    ' Try to remove an existing item, 
    ' demonstrating that the search isn't 
    ' case sensitive.
    TryRemove(builder, "DATA SOURCE")
    Console.ReadLine()
End Sub

Sub TryRemove(ByVal builder As DbConnectionStringBuilder, _
    ByVal itemToRemove As String)

    If builder.Remove(itemToRemove) Then
        Console.WriteLine("Removed '{0}'", itemToRemove)
    Else
        Console.WriteLine("Unable to remove '{0}'", itemToRemove)
    End If
    Console.WriteLine(builder.ConnectionString)
End Sub

이 샘플은 다음 출력을 표시합니다.

Removed 'Provider'
data source=C:\Demo.mdb;jet oledb:system database=system.mdw
Unable to remove 'User ID'
data source=C:\Demo.mdb;jet oledb:system database=system.mdw
Removed 'DATA SOURCE'
jet oledb:system database=system.mdw

설명

메서드는 Remove 성공을 나타내는 값을 반환하므로 instance 키/값 쌍 DbConnectionStringBuilder 을 제거하기 전에 키를 찾을 필요가 없습니다.

추가 정보

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