Поделиться через


SqlConnectionStringBuilder.Remove(String) Метод

Определение

Удаляет из экземпляра 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.

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

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

Исключения

Параметр keyword является пустой ссылкой (Nothing в Visual Basic).

Примеры

В следующем примере выполняется преобразование существующей строки подключения с использования аутентификации Windows на использование встроенной безопасности. В примере это выполняется путем удаления имени и пароля пользователя из строки подключения с последующим заданием значения свойства IntegratedSecurity объекта SqlConnectionStringBuilder.

Примечание

В этом примере для демонстрации взаимодействия класса SqlConnectionStringBuilder со строками подключения используется пароль. В приложениях рекомендуется использовать аутентификацию Windows. Если необходимо использовать пароль, то не следует включать в приложение пароли, жестко заданные в коде.

using System.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();
    }
}
Imports System.Data.SqlClient
    
Module Module1
  Sub Main()
    Try
      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)

      ' 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 connection As New SqlConnection(builder.ConnectionString)
        connection.Open()
        ' Now use the open connection.
        Console.WriteLine("Database = " & connection.Database)
      End Using

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

    Console.WriteLine("Press any key to finish.")
    Console.ReadLine()
  End Sub
End Module

В этом примере отображается следующий текст в окне консоли:

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.

Ключ Значение по умолчанию
Application Name «.NET SqlClient Data Provider»
Asynchronous Processing Неверно
AttachDBFilename Пустая строка.
Connection Timeout 15
Context Connection Неверно
Current Language Пустая строка.
источника данных Пустая строка.
Encrypt Неверно
Enlist Верно
Failover Partner Пустая строка.
Initial Catalog Пустая строка.
Integrated Security Неверно
Load Balance Timeout 0
Max Pool Size 100
Min Pool Size 0
MultipleActiveResultSets Неверно
Network Library Пустая строка.
Packet Size 8000
Пароль Пустая строка.
Сохранять сведения о безопасности Неверно
Pooling Верно
Replication Неверно
Transaction Binding Implicit Unbind
User ID Пустая строка.
User Instance Неверно
Workstation ID Пустая строка.

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

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