OdbcConnection.ConnectionString Właściwość

Definicja

Przestrzeń nazw:

System.Data.Odbc

Zestaw:

System.Data.Odbc.dll

Pakiet:

System.Data.Odbc v8.0.0

Source:

OdbcConnection.cs

Pobiera lub ustawia ciąg używany do otwierania źródła danych.

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

Wartość właściwości

String

Parametry połączenia sterownika ODBC, które zawierają ustawienia, takie jak nazwa źródła danych, potrzebne do nawiązania połączenia początkowego. Wartością domyślną jest ciąg pusty (""). Maksymalna długość to 1024 znaki.

Uwagi

Właściwość została zaprojektowana ConnectionString tak, aby pasować do formatu parametrów połączenia ODBC tak blisko, jak to możliwe. Można ConnectionString je ustawić tylko wtedy, gdy połączenie jest zamknięte, a gdy tylko zostanie ono ustawione, bez zmian, do Menedżera sterowników i podstawowego sterownika. W związku z tym składnia ConnectionString elementu musi dokładnie odpowiadać obsłudze sterowników i bazowego sterownika.

Za pomocą ConnectionString właściwości można nawiązać połączenie z różnymi źródłami danych. Obejmuje to nazwę źródła danych ODBC (DSN). Poniższy przykład ilustruje kilka możliwych parametrów połączenia.

"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"

Uwaga

Dostawca danych .NET Framework dla ODBC nie obsługuje słowa kluczowego Persist Security Info obsługiwanego przez innych dostawców danych .NET Framework. ConnectionString Jednak właściwość zachowuje się tak, jakby Persist Security Info została ustawiona na false. Oznacza to, że nie można pobrać hasła z właściwości, ConnectionString jeśli połączenie zostało otwarte. ConnectionString Gdy właściwość jest odczytywana z OdbcConnection otwartego obiektu, parametry połączenia są zwracane pomniejszone o hasło. Nie można zmienić tego zachowania; w związku z tym, jeśli aplikacja wymaga hasła, zapisz ją oddzielnie przed wywołaniem metody Open.

Wiele ustawień określonych w ciągu ma odpowiednie właściwości tylko do odczytu (na przykład , Server=(local)które odpowiadają DataSource właściwości). Te właściwości są aktualizowane po otwarciu połączenia, z wyjątkiem przypadków wykrycia błędu. W takim przypadku żadna z właściwości nie jest aktualizowana. OdbcConnection właściwości (takie jak Database) zwracają tylko ustawienia domyślne lub te ustawienia określone w elemecie ConnectionString.

W Microsoft .NET Framework w wersji 1.0 weryfikacja parametrów połączenia nie występuje, dopóki aplikacja nie wywoła Open metody . Jest to odpowiedzialność za podstawowy sterownik ODBC w celu zweryfikowania parametrów połączenia. Jeśli parametry połączenia zawierają nieprawidłowe lub nieobsługiwane właściwości, sterownik może zgłosić OdbcException błąd w czasie wykonywania.

Jednak w wersji .NET Framework w wersji 1.1 lub nowszej niektóre podstawowe weryfikacje parametrów połączenia następuje zaraz po ustawieniu ConnectionString właściwości. W tym czasie dostawca danych sprawdza, czy parametry połączenia spełniają wartość "keyword=value;..." format, ale nie sprawdza, czy słowa kluczowe lub wartości są prawidłowe. Pozostała weryfikacja jest wykonywana przez podstawowy sterownik ODBC, gdy aplikacja wywołuje metodę Open .

Parametry połączenia ODBC mają następującą składnię:

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

gdzie character-string ma zero lub więcej znaków; identifierattribute-keyword ma co najmniej jeden znak; nie jest rozróżniana wielkość liter; attribute-value może być rozróżniana wielkość liter; a wartość słowa kluczowego DSN nie składa się tylko z pustych znaków.

Ze względu na parametry połączenia i gramatykę pliku inicjowania należy unikać słów kluczowych i wartości atrybutów, które zawierają znaki []{}(),;? *=!@ nie ujęty w nawiasy klamrowe. Wartość słowa kluczowego DSN nie może składać się tylko z pustych wartości i nie powinna zawierać wiodących wartości pustych. Ze względu na gramatykę informacji systemowych słowa kluczowe i nazwy źródeł danych nie mogą zawierać znaku ukośnika odwrotnego (\).

Aplikacje nie muszą dodawać nawiasów klamrowych wokół wartości atrybutu po słowie kluczowym Sterownik, chyba że atrybut zawiera średnik (;), w którym przypadku wymagane są nawiasy klamrowe. Jeśli wartość atrybutu odbieranego przez sterownik zawiera nawiasy klamrowe, sterownik nie powinien ich usuwać, ale powinien być częścią zwracanych parametrów połączenia.

Nazwa DSN lub wartość parametrów połączenia ujęta w nawiasy klamrowe ({}), które zawierają dowolne znaki []{}(),;? *=!@ jest przekazywany bez zmian do sterownika. Jednak w przypadku używania tych znaków w słowie kluczowym Menedżer sterowników zwraca błąd podczas pracy z nazwami DSN plików, ale przekazuje parametry połączenia do sterownika dla zwykłych parametrów połączenia. Unikaj używania osadzonych nawiasów klamrowych w wartości słowa kluczowego.

Parametry połączenia mogą zawierać dowolną liczbę słów kluczowych zdefiniowanych przez sterownik. Ponieważ słowo kluczowe DRIVER nie używa informacji z systemu, sterownik musi zdefiniować wystarczające słowa kluczowe, aby sterownik mógł połączyć się ze źródłem danych przy użyciu tylko informacji w parametrach połączenia. Sterownik definiuje słowa kluczowe wymagane do nawiązania połączenia ze źródłem danych.

Jeśli jakiekolwiek słowa kluczowe są powtarzane w parametrach połączenia, nie ma gwarancji, która wartość zostanie wybrana.

Uwaga

Jeśli sterownik ODBC obsługuje parametry połączenia dłuższe niż 1024 znaki, możesz użyć nazwy źródła danych (DSN), aby przekroczyć ograniczenie maksymalnej długości.

Zobacz też

• Nawiązywanie połączenia ze źródłami danych