OdbcConnection.ConnectionString Vlastnost

Definice

Obor názvů:

System.Data.Odbc

Sestavení:

System.Data.Odbc.dll

Balíček:

System.Data.Odbc v9.0.0-rc.2.24473.5

Zdroj:

OdbcConnection.cs

Získá nebo nastaví řetězec použitý k otevření zdroje dat.

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

Hodnota vlastnosti

String

Ovladač ODBC připojovací řetězec, který obsahuje nastavení, jako je název zdroje dat, potřebný k navázání počátečního připojení. Výchozí hodnota je prázdný řetězec (""). Maximální délka je 1024 znaků.

Poznámky

Vlastnost ConnectionString je navržena tak, aby co nejvíce odpovídala formátu odbc připojovací řetězec. Vlastnost ConnectionString lze nastavit pouze v případě, že je připojení ukončeno, a jakmile je nastaveno, předá se beze změny správci ovladačů a podkladovému ovladači. Syntaxe nástroje ConnectionString proto musí přesně odpovídat tomu, co podporuje Správce ovladačů a podkladový ovladač.

Vlastnost můžete použít ConnectionString k připojení k různým zdrojům dat. To zahrnuje název zdroje dat ODBC (DSN). Následující příklad ukazuje několik možných připojovacích řetězců.

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

Poznámka

Zprostředkovatel dat rozhraní .NET Framework pro rozhraní ODBC nepodporuje Persist Security Info klíčové slovo, které je podporováno jinými zprostředkovateli dat rozhraní .NET Framework. Vlastnost se ConnectionString však chová, jako by Persist Security Info byla nastavena na falsehodnotu . To znamená, že nelze načíst heslo z ConnectionString vlastnosti, pokud bylo připojení otevřeno. ConnectionString Při čtení vlastnosti z objektuOdbcConnection, který byl otevřen, je vrácena připojovací řetězec bez hesla. Toto chování nelze změnit; Proto pokud aplikace vyžaduje heslo, uložte jej samostatně před voláním Open.

Mnoho nastavení zadaných v řetězci má odpovídající vlastnosti jen pro čtení (například Server=(local), které odpovídají DataSource vlastnosti ). Tyto vlastnosti se aktualizují po otevření připojení, s výjimkou případů, kdy je zjištěna chyba. V tomto případě se neaktualizují žádné vlastnosti. OdbcConnection Vlastnosti (například Database) vrací pouze výchozí nastavení nebo nastavení zadaná v ConnectionString.

V rozhraní Microsoft .NET Framework verze 1.0 ověření připojovací řetězec neprovádí, dokud aplikace nezavolá metodu Open . Ověření připojovací řetězec je zodpovědností základního ovladače ODBC. Pokud připojovací řetězec obsahuje neplatné nebo nepodporované vlastnosti, může ovladač vyvolat chybu OdbcException za běhu.

V rozhraní .NET Framework verze 1.1 a novějších verzích však dojde k určitému základnímu ověření připojovací řetězec, jakmile nastavíte ConnectionString vlastnost . V té době zprostředkovatel dat ověří, že připojovací řetězec splňuje "keyword=value;..." formát, ale neověřuje, zda jsou klíčová slova nebo hodnoty platné. Zbývající ověření provádí základní ovladač ODBC, když aplikace volá metodu Open .

Připojovací řetězec ODBC má následující syntaxi:

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

kde character-string obsahuje nula nebo více znaků; identifier obsahuje jeden nebo více znaků; attribute-keyword nerozlišuje malá a velká písmena; attribute-value může rozlišovat malá a velká písmena; a hodnota klíčového slova DSN se neskládá pouze z prázdných hodnot.

Z důvodu gramatiky připojovací řetězec a inicializace souboru je třeba se vyhnout klíčovým slovům a hodnotám atributů, které obsahují znaky []{}(),;? *=!@ není uzavřeno se složenými závorkami. Hodnota klíčového slova DSN nemůže obsahovat pouze prázdné hodnoty a neměla by obsahovat počáteční prázdné hodnoty. Z důvodu gramatiky systémových informací nemohou klíčová slova a názvy zdrojů dat obsahovat znak zpětného lomítka (\).

Aplikace nemusí přidávat složené závorky kolem hodnoty atributu za klíčové slovo Driver, pokud atribut neobsahuje středník (;), v takovém případě jsou složené závorky povinné. Pokud hodnota atributu, kterou ovladač obdrží, obsahuje složené závorky, ovladač by je neměl odebrat, ale měl by být součástí vrácených připojovací řetězec.

Hodnota DSN nebo připojovací řetězec uzavřená se složenými závorkami ({}), která obsahuje některý ze znaků []{}(),;? *=!@ se ovladači předá beze změny. Pokud však tyto znaky použijete v klíčovém slově, Správce ovladačů vrátí chybu při práci se souborovými názvy DSN, ale předá ovladači připojovací řetězec pro běžné připojovací řetězce. Nepoužívejte v hodnotě klíčového slova vložené složené závorky.

Připojovací řetězec může obsahovat libovolný počet klíčových slov definovaných ovladačem. Vzhledem k tomu, že klíčové slovo DRIVER nepoužívá informace ze systému, musí ovladač definovat dostatek klíčových slov, aby se ovladač mohl připojit ke zdroji dat pouze pomocí informací v připojovací řetězec. Ovladač definuje, která klíčová slova se vyžadují pro připojení ke zdroji dat.

Pokud se některá klíčová slova v připojovací řetězec opakují, není zaručeno, která hodnota bude vybrána.

Poznámka

Pokud ovladač ODBC podporuje připojovací řetězce delší než 1024 znaků, můžete k překročení omezení maximální délky použít název zdroje dat (DSN).

Viz také

• Připojení ke zdrojům dat