Sdílet prostřednictvím

Připojovací řetězce v ADO.NET

Připojovací řetězec obsahuje informace o inicializaci, které se předávají jako parametr zprostředkovatele dat do zdroje dat. Jako hodnotu vlastnosti DbConnection.ConnectionString obdrží zprostředkovatel dat připojovací řetězec. Zprostředkovatel analyzuje připojovací řetězec a zajišťuje správnost syntaxe a podporu klíčových slov. DbConnection.Open() Pak metoda předává parsované parametry připojení ke zdroji dat. Zdroj dat provede další ověření a vytvoří připojení.

Syntaxe připojovacího řetězce

Připojovací řetězec je seznam párů parametrů klíč/hodnota oddělený středníkem:

keyword1=value; keyword2=value;

Klíčová slova nerozlišují malá a velká písmena. Hodnoty však mohou být citlivé na velikost písmen v závislosti na zdroji dat. Klíčová slova i hodnoty můžou obsahovat prázdné znaky. Počáteční a koncové prázdné znaky se ignorují v klíčových slovech a necitovaných hodnotách.

Pokud hodnota obsahuje středník, znaky ovládacího prvku Unicode nebo počáteční nebo koncové prázdné znaky, musí být uzavřeny do jednoduchých nebo dvojitých uvozovek. Příklad:

Keyword=" whitespace  ";
Keyword='special;character';

Uzavírací znak nesmí být obsažen v hodnotě, kterou uzavírá. Proto lze hodnotu obsahující jednoduché uvozovky uzavřít pouze do dvojitých uvozovek a naopak:

Keyword='double"quotation;mark';
Keyword="single'quotation;mark";

Můžete také uniknout ohraničujícímu znaku pomocí zdvojení.

Keyword="double""quotation";
Keyword='single''quotation';

Samotné uvozovky i znaménko rovná se nevyžadují escape sekvenci, takže jsou platné následující připojovací řetězce:

Keyword=no "escaping" 'required';
Keyword=a=b=c

Vzhledem k tomu, že každá hodnota je přečtená do dalšího středníku nebo konce řetězce, hodnota v druhém příkladu je a=b=ca poslední středník je nepovinný.

Všechny připojovací řetězec sdílejí stejnou základní syntaxi popsanou dříve. Sada rozpoznaných klíčových slov ale závisí na poskytovateli a v průběhu let se vyvinula z předchozích rozhraní API, jako je ODBC. Zprostředkovatel dat rozhraní .NET Framework pro SQL Server (SqlClient) podporuje mnoho klíčových slov ze starších rozhraní API, ale se obecně vyznačuje větší flexibilitou a přijímá synonyma pro mnoho běžných klíčových slov parametrů připojení.

Chyby při psaní můžou způsobit chyby. Je například Integrated Security=true platný, ale IntegratedSecurity=true způsobuje chybu.

Připojovací řetězce vytvořené ručně za běhu z nedůvěryhodného uživatelského vstupu jsou ohroženy útoky prostřednictvím injektáže řetězců a ohrožují zabezpečení ve zdroji dat. Pro řešení těchto problémů zavedlo ADO.NET 2.0 tvůrce připojovacích řetězců pro každého poskytovatele dat rozhraní .NET Framework. Tvůrci připojovacích řetězců zpřístupňují parametry jako silně typované vlastnosti a umožňují validovat připojovací řetězec před odesláním do zdroje dat.

Důležité

Microsoft doporučuje používat nejbezpečnější dostupný tok ověřování. Pokud se připojujete k Azure SQL, Spravované identity pro prostředky Azure jsou doporučenou metodou ověřování.

V této části

Sestavovače připojovacích řetězců
Demonstruje použití ConnectionStringBuilder tříd k vytvoření platných připojovacích řetězců za běhu.

Připojovací řetězce a konfigurační soubory
Ukazuje, jak ukládat a načítat připojovací řetězec v konfiguračních souborech.

Syntaxe připojovacího řetězce
Popisuje, jak nakonfigurovat připojovací řetězce specifické pro poskytovatele pro SqlClient, OracleClient, OleDb, a Odbc.

Ochrana informací o připojení
Demonstruje techniky ochrany informací používaných pro připojení ke zdroji dat.

Viz také

  • Last updated on