OracleConnectionStringBuilder.Remove(String) Метод

Ссылка

Определение

Пространство имен:: System.Data.OracleClient

Сборка:: System.Data.OracleClient.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

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

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

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

Boolean

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

Исключения

ArgumentNullException

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();
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before you can run this sample.
Imports System.Data.OracleClient

Module Module1

  Sub Main()
    Try
      Dim connectString As String = _
       "Data Source=OracleDemo;User ID=Mary;Password=*****;"

      Dim builder As 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 ex As Exception
      Console.WriteLine(ex.Message)
    End Try

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

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

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

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

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

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

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

Создание строк подключения