Прочитать на английском

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


OracleConnectionStringBuilder.Remove(String) Метод

Определение

Удаляет из экземпляра OracleConnectionStringBuilder запись с указанным ключом.

public override bool Remove (string keyword);

Параметры

keyword
String

Ключ пары «ключ-значение», удаляемой из строки подключения в этом объекте OracleConnectionStringBuilder.

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

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

Исключения

keyword имеет значение null (Nothing в Visual Basic).

Примеры

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

Примечание

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

// You may need to set a reference to the System.Data.OracleClient
// assembly before you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=OracleDemo;User ID=Mary;Password=*****";

            OracleConnectionStringBuilder builder = new OracleConnectionStringBuilder(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);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        Console.WriteLine("Press any key to finish.");
        Console.ReadLine();
    }
}

Комментарии

Remove Так как метод возвращает значение, указывающее на успешное выполнение, нет необходимости искать наличие ключа, прежде чем пытаться удалить пару "ключ-значение" из экземпляраOracleConnectionStringBuilder. OracleConnectionStringBuilder Так как поддерживает коллекцию пар "ключ-значение" фиксированного размера, вызов Remove метода просто сбрасывает значение пары "ключ-значение" до значения по умолчанию.

Поскольку коллекция ключей, поддерживаемая классом OracleConnectionStringBuilder, фиксирована, каждый элемент в коллекции имеет известное значение по умолчанию.

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

Ключ Значение по умолчанию
Источник данных Пустая строка.
Сохранять сведения о безопасности Неверно
Встроенные функции безопасности Неверно
Идентификатор пользователя. Пустая строка.
Пароль Пустая строка.
Enlist Верно
Pooling Верно
Min Pool Size 0
Max Pool Size 100
Юникод Неверно
Load Balance Timeout 0
Опустить имя подключения Oracle Неверно

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

Продукт Версии
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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