OracleConnectionStringBuilder.Item[String] Свойство

Определение

Пространство имен:

System.Data.OracleClient

Сборка:

System.Data.OracleClient.dll

Возвращает или задает значение, связанное с указанным ключом. В языке C# это свойство является индексатором.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };

public override object this[string keyword] { get; set; }

member this.Item(string) : obj with get, set

Default Public Overrides Property Item(keyword As String) As Object

Параметры

keyword

String

Ключ возвращаемого или задаваемого элемента.

Значение свойства

Object

Значение, связанное с указанным ключом.

Исключения

ArgumentNullException

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

KeyNotFoundException

Осуществлена попытка добавить несуществующий ключ.

FormatException

Недопустимое значение в строке подключения (в данном случае ожидаемое логическое или числовое значение не было передано).

Примеры

В следующем примере кода в консольном приложении создается класс OracleConnectionStringBuilder, после чего в его строку подключения с помощью свойства Item[] добавляются пары «ключ-значение».

// 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()
    {
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder();
        builder["Data Source"] = "localhost";
        builder["integrated security"] = true;
        builder["Unicode"] = true;

        // Overwrite the existing value for the Data Source value.
        builder["Data Source"] = "NewOracleDemo";

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();
        Console.WriteLine("Press Enter to continue.");
        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()
    Dim builder As New OracleConnectionStringBuilder
    builder.Item("Data Source") = "OracleDemo"
    ' Item is the default property, so 
    ' you need not include it in the reference.
    builder("integrated security") = True
    builder.Item("Unicode") = True

    ' Overwrite the existing value for the Data Source value.
    builder.Item("Data Source") = "NewOracleDemo"

    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()
    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
  End Sub
End Module

Комментарии

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

Ключ	Свойство	Значение по умолчанию
Источник данных (или сервер)	DataSource	Пустая строка.
Сохранение сведений о безопасности (или persistsecurityinfo)	PersistSecurityInfo	Неверно
Встроенные функции безопасности	IntegratedSecurity	Неверно
Идентификатор пользователя (или user или uid)	UserID	Пустая строка.
Пароль	Password	Пустая строка.
Enlist	Enlist	Верно
Pooling	Pooling	Верно
Min Pool Size	MinPoolSize	0
Max Pool Size	MaxPoolSize	100
Опустить имя подключения Oracle	OmitOracleConnectionName	Неверно
Юникод	Unicode	Неверно
Время ожидания балансировки нагрузки (или время существования подключения)	LoadBalanceTimeout	0

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

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