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

Примеры

В следующем примере создается 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. Для поддержания высокого уровня безопасности настоятельно рекомендуется использовать ключевое слово Integrated Security.
Сохранять сведения о безопасности	"false"	Если задано значение false или no (настоятельно рекомендуется), конфиденциальные сведения о безопасности, такие как пароль, не возвращаются в составе подключения, если подключение открыто или когда-либо находилось в открытом State. При сбросе строки подключения будут сброшены все ее значения, включая пароль. Допустимые значения: true, false, yes и no.
Юникод	"false"	Указывает, использует ли поставщик данных платформа .NET Framework для Oracle вызовы API в режиме UTF16. Это ключевое слово игнорируется, за исключением случаев, когда используется клиентское программное обеспечение Oracle9i.
Идентификатор пользователя.		Учетная запись для входа Oracle. Для поддержания высокого уровня безопасности настоятельно рекомендуется использовать ключевое слово Integrated Security.

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