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


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

Определение

Возвращает или задает значение, связанное с указанным ключом. В языке 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

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

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

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

Исключения

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

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

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

Примеры

В следующем примере кода в консольном приложении создается класс 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

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

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