OracleConnection.ConnectionString Свойство

Определение

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

System.Data.OracleClient

Сборка:

System.Data.OracleClient.dll

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

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

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

String

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

Атрибуты

SettingsBindableAttribute

Комментарии

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

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

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

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

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

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

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

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

"key==word=value"

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

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

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

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

Имя	По умолчанию	Описание
Источник данных –или– Сервер		Имя или сетевой адрес экземпляра Oracle, к которому необходимо подключиться.
Встроенные функции безопасности	'false'	Независимо от того, является ли подключение безопасным или нет. Распознанные значения (настоятельно рекомендуется true ), falseи yesno.
Пароль		Пароль для входа учетной записи Oracle. Чтобы обеспечить высокий уровень безопасности, настоятельно рекомендуется использовать ключевое слово "Встроенная безопасность".
Сохранение сведений о безопасности	'false'	Если задано false значение или no (настоятельно рекомендуется), конфиденциальные сведения о безопасности, такие как пароль, не возвращаются в рамках подключения, если подключение открыто или когда-либо находилось в открытом Stateрежиме. Сброс строки подключения сбрасывает все значения строки подключения, включая пароль. Допустимые значения: true, false, yes и no.
Юникод	'false'	Указывает, использует ли поставщик данных .NET Framework для Oracle вызовы API режима UTF16. Это ключевое слово игнорируется, за исключением использования клиентского программного обеспечения Oracle9i.
Идентификатор пользователя		Учетная запись входа Oracle. Чтобы обеспечить высокий уровень безопасности, настоятельно рекомендуется использовать ключевое слово "Встроенная безопасность".

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

Имя	По умолчанию	Описание
Время существования подключения	0	Если соединение возвращается в пул, время его создания сравнивается с текущим временем и соединение уничтожается, если этот промежуток времени (в секундах) превышает значение, заданное параметром Connection Lifetime. Эта возможность полезна в кластеризованных конфигурациях для принудительной балансировки нагрузки между выполняющимся сервером и сервером, только что переведенным в оперативный режим. Значение нуля приводит к тому, что пуловые подключения имеют максимальное время ожидания подключения.
Привлечь	'true'	Когда true или yes, пулизатор автоматически заверяет соединение в текущем контексте транзакции потока создания. Допустимые значения: true, false, yes и no.
Максимальный размер пула	100	Максимальное разрешенное количество соединений в пуле. Max Pool Size Задание значения ConnectionString может повлиять на производительность. Если вы планируете создавать и активно использовать более 100 подключений, необходимо увеличить Max Pool Size значение, которое приблизит использование подключения к устойчивому состоянию для приложения.
Минимальный размер пула	0	Минимальное количество подключений, разрешенных в пуле.
Объединение в пулы	'true'	Когда true или yes, OracleConnection объект извлекается из соответствующего пула или при необходимости создается и добавляется в соответствующий пул. Допустимые значения: true, false, yes и no.

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