OdbcConnection.ConnectionString Właściwość

Definicja

Przestrzeń nazw:

System.Data.Odbc

Zestaw:

System.Data.Odbc.dll

Pakiet:

System.Data.Odbc v8.0.0

Źródło:

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

Sterownik ODBC parametry połączenia, który zawiera 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 dopasować format ODBC parametry połączenia jak najbliżej. Można ConnectionString go 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 elementu ConnectionString musi dokładnie odpowiadać temu, co obsługuje Menedżer sterowników i podstawowy sterownik.

Możesz użyć ConnectionString właściwości , aby 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 falsewartość . Oznacza to, że nie można pobrać hasła z ConnectionString właściwości, jeśli połączenie zostało otwarte. ConnectionString Gdy właściwość jest odczytywana z OdbcConnection obiektu, który został otwarty, parametry połączenia jest zwracany pomniejszone o hasło. Nie można zmienić tego zachowania; w związku z tym, jeśli aplikacja wymaga hasła, zapisz je 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 sytuacji, gdy zostanie wykryty błąd. 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 programie Microsoft .NET Framework w wersji 1.0 weryfikacja parametry połączenia nie występuje, dopóki aplikacja nie wywoła Open metody . Obowiązkiem podstawowego sterownika ODBC jest zweryfikowanie parametry połączenia. Jeśli parametry połączenia zawiera nieprawidłowe lub nieobsługiwane właściwości, sterownik może zgłosić OdbcException błąd w czasie wykonywania.

Jednak w .NET Framework w wersji 1.1 i nowszych niektóre podstawowe weryfikacje parametry połączenia następuje zaraz po ustawieniu ConnectionString właściwości. W tym czasie dostawca danych sprawdza, czy parametry połączenia spełnia 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 ma 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; identifier ma co najmniej jeden znak; attribute-keyword nie uwzględnia wielkości liter; attribute-value może uwzględniać 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 tym przypadku nawiasy klamrowe są wymagane. Jeśli wartość atrybutu, którą otrzymuje sterownik, zawiera nawiasy klamrowe, sterownik nie powinien ich usuwać, ale powinien być częścią zwróconej parametry połączenia.

Wartość DSN lub parametry 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 może zawierać dowolną liczbę słów kluczowych zdefiniowanych przez sterownik. Ponieważ słowo kluczowe DRIVER nie używa informacji z systemu, sterownik musi zdefiniować wystarczająco dużo słów kluczowych, aby sterownik mógł połączyć się ze źródłem danych przy użyciu tylko informacji w parametry 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 parametry 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