SqlConnectionStringBuilder.Remove(String) Метод

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

Параметры

Возвращаемое значение

true, если ключ существовал в строке подключения и был удален; false, если ключ не существовал.

Исключения

Примеры

Следующий пример преобразует существующую строку подключения из использования проверки подлинности SQL Server в проверку подлинности Windows (встроенная безопасность). Пример работает путем удаления имени пользователя и пароля из строки подключения, а затем задания свойства IntegratedSecurity объекта SqlConnectionStringBuilder.

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 Remove возвращает значение, указывающее на его успех, перед попыткой удалить пару "ключ-значение" из экземпляра SqlConnectionStringBuilder не требуется. Так как SqlConnectionStringBuilder поддерживает коллекцию пар "ключ-значение" фиксированного размера, вызывая метод Remove, просто сбрасывает значение пары "ключ-значение" обратно в значение по умолчанию.

Так как коллекция ключей, поддерживаемых SqlConnectionStringBuilder, исправлена, каждый элемент в коллекции имеет известное значение по умолчанию. В следующей таблице перечислены ключи и значение для каждого из них при первом инициализации SqlConnectionStringBuilder или после вызова метода Remove.

Применяется к

См. также раздел

• строки подключения в ADO.NET
• обзора ADO.NET