Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Platí pro: 
.NET Framework .NET Standard
Připojovací řetězec obsahuje informace o inicializaci, které se předávají jako parametr zprostředkovatele dat do zdroje dat. Zprostředkovatel dat obdrží připojovací řetězec jako hodnotu DbConnection.ConnectionString vlastnosti. 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. V závislosti na zdroji dat ale můžou být citlivé na malá a velká písmena. 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. Například:
Keyword=" whitespace ";
Keyword='special;character';
Uzavírací znak nemusí nastat v hodnotě, kterou uzavře. 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é uvozit uzavírací znak pomocí dvou z nich dohromady:
Keyword="double""quotation";
Keyword='single''quotation';
Samotné uvozovky i znaménko rovná se nevyžadují uvozovky, takže jsou platné následující připojovací řetězec:
Keyword=no "escaping" 'required';
Keyword=a=b=c
Vzhledem k tomu, že každá hodnota se čte 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ězce sdílejí stejnou základní syntaxi popsanou výše. Sada rozpoznaných klíčových slov závisí na poskytovateli. Zprostředkovatel dat Microsoft SqlClient pro SQL Server podporuje mnoho klíčových slov ze starších rozhraní API, ale obecně flexibilnější a přijímá synonyma pro mnoho běžných klíčových slov připojovacího řetězce.
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ě v době běhu programu z nedůvěryhodného uživatelského vstupu jsou zranitelné vůči injekčním útokům a ohrožují zabezpečení zdroje dat. Pro řešení těchto problémů SqlConnectionStringBuilder byla vytvořena třída. Tato třída tvůrce připojovacích řetězců zveřejňuje parametry jako vlastnosti silného typu a umožňuje ověřit připojovací řetězec před odesláním do zdroje dat.
V této části
Tvůrce připojovacích řetězců
Ukazuje, jak třídu ConnectionStringBuilder použít k vytvoření platných připojovacích řetězců za běžného provozu.
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, které jsou specifické pro poskytovatele pro SqlClient.
Ochrana informací o připojení
Demonstruje techniky ochrany informací používaných pro připojení ke zdroji dat.