OdbcConnection.ConnectionString Свойство

Определение

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

System.Data.Odbc

Сборка:

System.Data.Odbc.dll

Пакет:

System.Data.Odbc v11.0.0-preview.2.26159.112

Исходный код:

OdbcConnection.cs

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

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

public override string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

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

String

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

Комментарии

Свойство ConnectionString предназначено для сопоставления формата строки подключения ODBC как можно ближе. ConnectionString Его можно задать только в том случае, если подключение закрыто, и как только он будет передан, без изменений, диспетчеру драйверов и базовому драйверу. Поэтому синтаксис для этого ConnectionString должен точно соответствовать тому, что поддерживает диспетчер драйверов и базовый драйвер.

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

"Driver={SQL Server};Server=(local);Trusted_Connection=Yes;Database=AdventureWorks;"

"Driver={Microsoft ODBC for Oracle};Server=ORACLE8i7;Persist Security Info=False;Trusted_Connection=Yes"

"Driver={Microsoft Access Driver (*.mdb)};DBQ=c:\bin\Northwind.mdb"

"Driver={Microsoft Excel Driver (*.xls)};DBQ=c:\bin\book1.xls"

"Driver={Microsoft Text Driver (*.txt; *.csv)};DBQ=c:\bin"

"DSN=dsnname"

Замечание

Поставщик данных .NET Framework для ODBC не поддерживает Persist Security Info ключевое слово, которое поддерживается другими поставщиками данных .NET Framework. Однако свойство ведет себя так, ConnectionString как если бы Persist Security Info оно было задано false. Это означает, что вы не можете получить пароль из ConnectionString свойства, если подключение было открыто. ConnectionString Когда свойство считывается из открытого OdbcConnection объекта, строка подключения возвращается минус пароль. Вы не можете изменить это поведение; Таким образом, если приложению требуется пароль, сохраните его отдельно перед вызовом Open.

Многие параметры, указанные в строке, имеют соответствующие свойства только для чтения (например, Server=(local)которые соответствуют свойству DataSource ). Эти свойства обновляются после открытия подключения, за исключением случаев обнаружения ошибки. В этом случае никакие свойства не обновляются. OdbcConnection свойства (например Database) возвращают только параметры по умолчанию или эти параметры, указанные в параметре ConnectionString.

Некоторые основные проверки строки подключения возникают сразу после задания ConnectionString свойства. В то время поставщик данных проверяет, соответствует ли строка подключения "keyword=value;..." формат, но он не проверяет допустимость ключевых слов или значений. Оставшаяся проверка выполняется базовым драйвером ODBC, когда приложение вызывает Open метод.

Строка подключения ODBC имеет следующий синтаксис:

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
empty-string ::=
attribute ::= attribute-keyword=attribute-value | DRIVER=[{]attribute-value[}]
attribute-keyword ::= DSN | UID | PWD
 | driver-defined-attribute-keyword
attribute-value ::= character-string
driver-defined-attribute-keyword ::= identifier

где character-string имеет ноль или несколько символов; identifier имеет один или несколько символов; attribute-keyword не учитывает регистр; может быть чувствительным к регистру; attribute-value значение ключевого слова DSN не состоит только из пустых.

Из-за строки подключения и грамматики файла инициализации следует избежать значений ключевых слов и атрибутов, содержащих символы []{}(),?? *=!@ не заключен в фигурные скобки. Значение ключевого слова DSN не может состоять только из пустых и не должно содержать пустые в начале. Из-за грамматики системной информации ключевые слова и имена источников данных не могут содержать символ обратной косой черты (\).

Приложениям не нужно добавлять фигурные скобки вокруг значения атрибута после ключевого слова Driver, если атрибут не содержит точку с запятой (;), в этом случае требуются фигурные скобки. Если значение атрибута, которое получает драйвер, включает фигурные скобки, драйвер не должен удалять их, но они должны быть частью возвращаемой строки подключения.

Значение строки DSN или строки подключения, заключенное с фигурными скобками ({}), которая содержит любой из символов []{}(),?? *=!@ передается в драйвер без изменений. Однако при использовании этих символов в ключевом слове диспетчер драйверов возвращает ошибку при работе с доменными именами файлов, но передает строку подключения драйверу для регулярных строк подключения. Избегайте использования внедренных фигурных скобок в значении ключевого слова.

Строка подключения может включать любое количество ключевых слов, определенных драйвером. Так как ключевое слово DRIVER не использует информацию из системы, драйвер должен определить достаточно ключевых слов, чтобы драйвер смог подключиться к источнику данных, используя только сведения в строке подключения. Драйвер определяет, какие ключевые слова необходимы для подключения к источнику данных.

Если в строке подключения повторяются какие-либо ключевые слова, не гарантируется, какое значение будет выбрано.

Замечание

Если драйвер ODBC поддерживает строки подключения дольше 1024 символов, можно использовать имя источника данных (DSN), чтобы превысить максимальное ограничение длины.

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

• Подключение к источникам данных