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


OracleConnection.ConnectionString Свойство

Определение

Возвращает или задает строку, используемую для открытия базы данных Oracle.

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public string ConnectionString { get; set; }
public override string ConnectionString { get; set; }
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set
Public Property ConnectionString As String
Public Overrides Property ConnectionString As String

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

Строка подключения Oracle, включающая параметры, необходимые для установления начального подключения, например имя сервера. Значение по умолчанию — пустая строка.

Реализации

Атрибуты

Примеры

В следующем примере создается OracleConnection и задаются некоторые его свойства в строка подключения.

public void CreateOracleConnection()
{
    string connectionString = "Data Source=Oracle8i;Integrated Security=yes";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: " + connection.ServerVersion
            + "\nDataSource: " + connection.DataSource);
    }
}
Public Sub CreateOracleConnection()
    Dim connectionString As String = _
       "Data Source=Oracle8i;Integrated Security=yes"

    Using connection As New OracleConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: " + connection.ServerVersion _
           + ControlChars.NewLine + "DataSource: " + connection.DataSource)
    End Using
End Sub

Комментарии

Можно ConnectionString задать только при закрытии подключения.

Для подключения к базе данных можно использовать ConnectionString свойство . В следующем примере показан типичный строка подключения.

"Data Source=Oracle8i;Integrated Security=yes"  

Многие из параметров, указанных в строке, имеют соответствующие свойства только для чтения (например, Data Source=MyServer, что соответствует свойству DataSource ). Если строка подключения задано, все эти свойства обновляются, если не будет обнаружена ошибка. В этом случае ни одно из свойств не обновляется. OracleConnection свойства возвращают только параметры по умолчанию или параметры, указанные ConnectionStringв .

При сбросе ConnectionString при закрытом подключении сбрасываются все значения строка подключения (и связанные свойства), включая пароль.

Строка подключения анализируется сразу после установки. Если при синтаксическом анализе отображаются ошибки в синтаксисе, создается исключение времени выполнения, например ArgumentException, . Другие ошибки можно найти только при попытке открыть подключение.

Базовый формат строка подключения — это ряд пар "ключевое слово/значение", разделенных точкой с запятой. Знак равенства (=) соединяет каждое ключевое слово и его значение. Чтобы включить значения, содержащие точку с запятой, одинарные или двойные кавычки, значение должно быть заключено в двойные кавычки. Если значение содержит точку с запятой и символ двойной кавычки, значение может быть заключено в одинарные кавычки. Одна кавычка также полезна, если значение начинается с символа двойной кавычки. И наоборот, двойную кавычку можно использовать, если значение начинается с одной кавычки. Если значение содержит как одинарные, так и двойные кавычки, символ кавычки, используемый для заключения значения, должен удваивать каждый раз, когда оно вступает в значение.

Чтобы включить предыдущие или конечные пробелы в строковое значение, значение должно быть заключено в одинарные или двойные кавычки. Все начальные или конечные пробелы вокруг целочисленных, логических или перечисляемых значений игнорируются, даже если они заключены в кавычки. Однако пробелы внутри строкового литерала ключевое слово или значения сохраняются. Одинарные или двойные кавычки могут использоваться в строка подключения без использования разделителей, если символ кавычки не является первым или последним символом в значении, например или Data Source= my'ServerData Source= my"Server.

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

"key==word=value"  

ключевое слово — "key=word", а значение — "value".

Если определенная ключевое слово в паре "ключевое слово/значение" встречается несколько раз в строка подключения, в наборе значений используется последнее вхождение.

Ключевые слова не учитывают регистр.

В следующей таблице перечислены допустимые имена значений ConnectionStringв .

Имя По умолчанию Описание
Источник данных

-или-

Сервер
Имя или сетевой адрес экземпляра Oracle, к которому необходимо подключиться.
Встроенные функции безопасности "false" Должно ли соединение быть защищенным.

Распознанные значения: true (настоятельно рекомендуется), false, yesи no.
Пароль Пароль для входа в учетную запись Oracle. Для поддержания высокого уровня безопасности настоятельно рекомендуется использовать ключевое слово встроенной безопасности.
Сохранять сведения о безопасности "false" Если задано значение false или no (настоятельно рекомендуется), конфиденциальные сведения о безопасности, такие как пароль, не возвращаются в составе подключения, если подключение открыто или когда-либо находилось в открытом State. При сбросе строки подключения будут сброшены все ее значения, включая пароль.

Допустимые значения: true, false, yes и no.
Юникод "false" Указывает, использует ли поставщик данных платформа .NET Framework для Oracle вызовы API в режиме UTF16. Эта ключевое слово игнорируется, за исключением случаев, когда используется клиентское программное обеспечение Oracle9i.
Идентификатор пользователя. Учетная запись для входа Oracle. Для поддержания высокого уровня безопасности настоятельно рекомендуется использовать ключевое слово встроенной безопасности.

В следующей таблице перечислены допустимые имена для значений пула подключений в ConnectionString.

Имя По умолчанию Описание
Время существования подключения 0 Если соединение возвращается в пул, время его создания сравнивается с текущим временем и соединение уничтожается, если этот промежуток времени (в секундах) превышает значение, заданное параметром Connection Lifetime. Эта возможность полезна в кластеризованных конфигурациях для принудительной балансировки нагрузки между выполняющимся сервером и сервером, только что переведенным в оперативный режим.

Нулевое значение приводит к тому, что для подключений в пуле установлено максимальное время ожидания подключения.
Enlist 'true' При true значении или yesпул автоматически заверяет соединение в контексте текущей транзакции потока создания.

Допустимые значения: true, false, yes и no.
Max Pool Size 100 Максимальное число разрешенных соединений в пуле. Max Pool Size Установка значения ConnectionString может повлиять на производительность. Если вы планируете создать и активно использовать более 100 подключений, следует увеличить Max Pool Size до значения, которое приблизительно соответствует использованию устойчивых подключений для приложения.
Min Pool Size 0 Минимальное количество подключений, разрешенных в пуле.
Pooling 'true' При true использовании или yesOracleConnection объект извлекается из соответствующего пула или при необходимости создается и добавляется в соответствующий пул.

Допустимые значения: true, false, yes и no.

При установке ключевое слово или значений пула подключений, для которых требуется логическое значение, можно использовать "да" вместо "true" и "нет" вместо "false". Целочисленные значения представляются в виде строк.

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