OdbcConnection.ConnectionString Vlastnost

Definice

Obor názvů:

System.Data.Odbc

Sestavení:

System.Data.Odbc.dll

Balíček:

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

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

Připojovací řetězec ovladače ODBC, který obsahuje nastavení, například 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 nejblíže odpovídala formátu připojovacího řetězce ODBC. Lze ConnectionString nastavit pouze v případě, že je připojení uzavřeno, a jakmile je nastavena, je předán, beze změny, do Správce ovladačů a podkladového ovladače. Proto musí syntaxe přesně ConnectionString odpovídat tomu, co správce ovladačů a podkladová podpora ovladačů.

Vlastnost můžete použít ConnectionString k připojení k nejrůznější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 podporované jinými zprostředkovateli dat rozhraní .NET Framework. Vlastnost ConnectionString se však chová, jako by Persist Security Info byla nastavena na false. To znamená, že pokud bylo připojení otevřeno, nemůžete z vlastnosti načíst heslo ConnectionString . ConnectionString Při čtení vlastnosti z objektuOdbcConnection, který byl otevřen, připojovací řetězec se vrátí minus heslo. 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ídá DataSource vlastnosti). Tyto vlastnosti se aktualizují po otevření připojení, s výjimkou případů, kdy se zjistí chyba. V tomto případě se žádná z vlastností neaktualizuje. OdbcConnection vlastnosti (například Database) vrací pouze výchozí nastavení nebo tato nastavení zadaná v ConnectionStringsouboru .

Jakmile vlastnost nastavíte ConnectionString , dojde k základnímu ověření připojovacího řetězce. V té době zprostředkovatel dat ověřuje, že připojovací řetězec splňuje klíčové slovo =hodnota;..." formát, ale neověřuje, zda jsou klíčová slova nebo hodnoty platné. Zbývající ověření provádí základní ovladač ODBC při volání Open metody aplikace.

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

pokud character-string má nula nebo více znaků; identifier má jeden nebo více znaků; attribute-keyword nerozlišuje malá a velká písmena; attribute-value může být citlivá na velká a malá písmena a hodnota klíčového slova DSN se skládá pouze z prázdných znaků.

Z důvodu gramatiky připojovacího řetězce a inicializačního souboru by se měla 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 úvodní prázdné hodnoty. Z důvodu gramatiky systémových informací nemohou klíčová slova a názvy zdrojů dat obsahovat zpětné lomítko (\).

Aplikace nemusí za klíčové slovo Driver přidávat složené závorky, pokud atribut neobsahuje středník (;), v takovém případě jsou vyžadovány složené závorky. 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ého připojovacího řetězce.

DsN nebo hodnota připojovacího řetězce uzavřená se složenými závorkami ({}), která obsahuje některý ze znaků []{}();? *=!@ je předán beze změny ovladači. 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 sítěmi DSN, ale předá připojovací řetězec ovladači pro běžné připojovací řetězce. Nepoužívejte vložené složené závorky v hodnotě klíčového slova.

Připojovací řetězec může obsahovat libovolný počet klíčových slov definovaných ovladačem. Protož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ím řetězci. Ovladač definuje, která klíčová slova jsou nutná pro připojení ke zdroji dat.

Pokud se v připojovacím řetězci opakují některá klíčová slova, neexistuje žádná záruka, kterou hodnotu vyberete.

Poznámka:

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

Viz také

• Připojení ke zdrojům dat