SqlConnection.ConnectionString Vlastnost

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v7.0.1

Získá nebo nastaví řetězec použitý k otevření databáze SQL Serveru.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Hodnota vlastnosti

String

Připojovací řetězec, který obsahuje název zdrojové databáze, a další parametry potřebné k navázání počátečního připojení. Výchozí hodnota je prázdný řetězec.

Atributy

SettingsBindableAttribute

Výjimky

ArgumentException

Byl zadán neplatný argument připojovacího řetězce nebo nebyl zadán požadovaný argument připojovacího řetězce.

Příklady

Následující příklad vytvoří SqlConnection a nastaví ConnectionString vlastnost před otevřením připojení.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    private static void OpenSqlConnection()
    {
        string connectionString = GetConnectionString();

        using (SqlConnection connection = new SqlConnection())
        {
            connection.ConnectionString = connectionString;

            connection.Open();

            Console.WriteLine("State: {0}", connection.State);
            Console.WriteLine("ConnectionString: {0}",
                connection.ConnectionString);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file.
        return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
            + "Integrated Security=true;";
    }
}

Následující příklad vytvoří SqlConnection a nastaví ConnectionString vlastnost před otevřením připojení.

using System;
using System.Data;
using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    private static void OpenSqlConnection()
    {
        string connectionString = GetConnectionString();

        using (SqlConnection connection = new SqlConnection())
        {
            connection.ConnectionString = connectionString;

            connection.Open();

            Console.WriteLine("State: {0}", connection.State);
            Console.WriteLine("ConnectionString: {0}",
                connection.ConnectionString);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file.
        return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
            + "Integrated Security=true;";
    }
}

Poznámky

Podobá se ConnectionString připojovacímu řetězci OLE DB, ale není identický. Na rozdíl od OLE DB nebo ADO je připojovací řetězec vrácený stejně jako uživatelská sada ConnectionString, minus informace o zabezpečení, pokud je hodnota Trvalé informace o zabezpečení nastavena na false (výchozí). Zprostředkovatel dat rozhraní .NET Framework pro SQL Server neuchovává nebo nevrací heslo v připojovacím řetězci, pokud nenastavíte trvalé bezpečnostní údaje na truehodnotu .
Vlastnost můžete použít ConnectionString k připojení k databázi. Následující příklad znázorňuje typický připojovací řetězec.

"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"  

SqlConnectionStringBuilder Nové použijte k vytvoření platných připojovacích řetězců za běhu. Další informace naleznete v tématu Tvůrci řetězců připojení.

ConnectionString Vlastnost lze nastavit pouze při zavření připojení. Mnoho hodnot připojovacího řetězce má odpovídající vlastnosti jen pro čtení. Při nastavení připojovacího řetězce se tyto vlastnosti aktualizují s výjimkou případů, kdy se zjistí chyba. V tomto případě se žádná z vlastností neaktualizuje. SqlConnection vlastnosti vrátí pouze nastavení obsažená v objektu ConnectionString.

Pokud se chcete připojit k místnímu počítači, zadejte pro server "(local)". Pokud není zadaný název serveru, pokusí se připojení k výchozí instanci v místním počítači.

Resetováním ConnectionString u uzavřeného připojení se obnoví všechny hodnoty připojovacího řetězce (a související vlastnosti) včetně hesla. Pokud například nastavíte připojovací řetězec, který obsahuje "Database= AdventureWorks", a pak obnovíte připojovací řetězec na "Data Source=myserver; Integrated Security=true, Database vlastnost již není nastavena na AdventureWorks.

Připojovací řetězec se parsuje okamžitě po nastavení. Pokud se při analýze najdou chyby v syntaxi, vygeneruje se výjimka za běhu, například ArgumentException. Další chyby lze najít pouze v případech, kdy se pokusíte otevřít připojení.

Základní formát připojovacího řetězce obsahuje řadu dvojic klíčových slov a hodnot oddělených středníky. Symbol rovná se (=) spojuje každé klíčové slovo a jeho hodnotu. Chcete-li zahrnout hodnoty, které obsahují středník, znak jednoduché uvozovky nebo znak dvojité uvozovky, musí být hodnota uzavřena do dvojitých uvozovek. Pokud hodnota obsahuje středník i znak dvojité uvozovky, může být hodnota uzavřena do jednoduchých uvozovek. Jednoduchá uvozovka je užitečná také v případě, že hodnota začíná dvojitým uvozovkovým znakem. Naopak dvojitá uvozovka se dá použít, pokud hodnota začíná jednoduchým uvozovkam. Pokud hodnota obsahuje znaky jednoduché uvozovky i dvojité uvozovky, musí se znak uvozovek použitý k uzavření hodnoty zdvojnásobit při každém výskytu hodnoty.

Pokud chcete do řetězcové hodnoty zahrnout předchozí nebo koncové mezery, musí být tato hodnota uzavřena do jednoduchých uvozovek nebo dvojitých uvozovek. Všechny úvodní nebo koncové mezery kolem celého čísla, logické hodnoty nebo výčtu se ignorují, i když jsou uzavřené v uvozovkách. Mezery v řetězcovém literálovém klíčovém slově nebo hodnotě se však zachovají. Jednoduché nebo dvojité uvozovky lze použít v rámci připojovacího řetězce bez použití oddělovačů (například Zdroj dat= my'Server nebo Zdroj dat= my"Server), pokud není znak uvozovek prvním nebo posledním znakem v hodnotě.

Klíčová slova nerozlišují malá a velká písmena.

Následující tabulka uvádí platné názvy hodnot klíčových slov v rámci .ConnectionString

Klíčové slovo	Výchozí	Description
Addr	N/A	Synonymum zdroje dat
Adresa	N/A	Synonymum zdroje dat
Aplikace	N/A	Synonymum názvu aplikace
Záměr aplikace - nebo - Záměr aplikace	Čtení a zápis	Deklaruje typ úlohy aplikace při připojování k serveru. Možné hodnoty jsou ReadOnly a ReadWrite. Příklad: ApplicationIntent=ReadOnly Další informace o podpoře SqlClient pro skupiny dostupnosti AlwaysOn naleznete v tématu Podpora SqlClient pro vysokou dostupnost, zotavení po havárii.
Název aplikace	N/A	Název aplikace. Pokud není zadaný žádný název aplikace, v opačném případě se v .NET Frameworku Zprostředkovatel dat Rozhraní Framework Microsoft SqlClient a Core Microsoft SqlClient Zprostředkovatel dat. Název aplikace může mít 128 znaků nebo méně.
Attachdbfilename - nebo - Rozšířené vlastnosti - nebo - Počáteční název souboru	N/A	Název primárního databázového souboru, včetně úplného názvu cesty připojitelné databáze. AttachDBFilename je podporován pouze pro primární datové soubory s příponou .mdf. Pokud je v připojovacím řetězci zadána hodnota klíče AttachDBFileName, databáze se připojí a stane se výchozí databází pro připojení. Pokud tento klíč není zadaný a pokud byla databáze dříve připojena, databáze se znovu nepřipojee. Dříve připojená databáze se použije jako výchozí databáze připojení. Pokud je tento klíč zadán společně s klíčem AttachDBFileName, použije se jako alias hodnota tohoto klíče. Pokud je však název již použit v jiné připojené databázi, připojení se nezdaří. Cesta může být absolutní nebo relativní pomocí řetězce nahrazení DataDirectory. Pokud se použije DataDirectory, soubor databáze musí existovat v podadresáři adresáře, na který odkazuje řetězec nahrazení. Poznámka: Názvy cest VZDÁLENÉho serveru, HTTP a UNC nejsou podporovány. Název databáze musí být zadán klíčovým slovem "database" (nebo jedním z jeho aliasů), jak je uvedeno v následujícím příkladu: "AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase" Pokud soubor protokolu existuje ve stejném adresáři jako datový soubor, vygeneruje se chyba a při připojování primárního datového souboru se použije klíčové slovo "databáze". V takovém případě odeberte soubor protokolu. Po připojení databáze se automaticky vygeneruje nový soubor protokolu na základě fyzické cesty.
Protokol ověření identity	Nespecifikováno	Získá nebo nastaví hodnotu Attestation Protocol. Pokud není zadána žádná hodnota, zabezpečené enklávy jsou v připojení zakázány. Platné hodnoty jsou: AAS HGS None (Platné pouze ve verzi 3.1 a v4.1+))
Authentication	N/A	Metoda ověřování použitá pro Pojení ke službě SQL Database pomocí ověřování Entra ID. Platné hodnoty jsou: služba Active Directory Integrated, služba Active Directory Interactive, , služba Active Directory Password, služba Active Directory Service Principal, služba Active Directory Device Code Flowslužba Active Directory Managed Identity, služba Active Directory MSI, služba Active Directory DefaultSql Password. Další informace najdete v tématu Using ověřování Entra ID pomocí SqlClient.
Nastavení šifrování sloupce	neaktivní	Povolí nebo zakáže funkci Always Encrypted pro připojení. Podporované hodnoty jsou: enabled a disabled
Časový limit příkazu	30	Výchozí doba čekání (v sekundách) před ukončením pokusu o spuštění příkazu a vygenerováním chyby. Platné hodnoty jsou větší než nebo rovny 0 a menší nebo rovny 2147483647.
Počet opakování připojení - nebo - ConnectRetryCount	1	Určuje počet pokusů o opětovné připojení po klientovi, který identifikuje selhání nečinného připojení. Platné hodnoty jsou 0 až 255. 0 znamená, že se nepokoušejte znovu připojit (zakažte odolnost připojení). Poznámka: Vzhledem k tomu, že verze 5.x výchozí hodnota pro jiné koncové body než Azure je 1. U koncových bodů Azure SQL je výchozí hodnota 2. U Azure SQL bezserverových koncových bodů nebo koncových bodů na vyžádání je výchozí hodnota 5, aby se zlepšil úspěch připojení pro připojení k nečinné nebo pozastavené instanci. Další informace o odolnosti nečinných připojení najdete v tématu .NET parametry SqlConnection pro opakování připojení a Technický článek – Odolnost připojení nečinnosti.
Interval opakovaného připojení - nebo - ConnectRetryInterval	10	Určuje čas mezi jednotlivými pokusy o opakování připojení (ConnectRetryCount). Platné hodnoty jsou 1 až 60 sekund (výchozí=10), které se použijí po prvním pokusu o opětovné připojení. Když se zjistí přerušené připojení, klient se okamžitě pokusí znovu připojit; toto je první pokus o opětovné připojení a nastane pouze v případě, že ConnectRetryCount je větší než 0. Pokud první pokus o opětovné připojení selže a ConnectRetryCount je větší než 1, klient počká ConnectRetryInterval na pokus o druhý a následné pokusy o opětovné připojení. Další informace o odolnosti nečinných připojení najdete v tématu.NET parametry sqlConnection pro opakování připojení a Počinný článek – Odolnost nečinných připojení.
Časový limit připojení - nebo - Vypršení časového limitu připojení - nebo - Přerušení zápasu	15	Doba (v sekundách) čekání na připojení k serveru před ukončením pokusu a vygenerováním chyby. Platné hodnoty jsou větší než nebo rovny 0 a menší nebo rovny 2147483647. Při otevírání připojení ke službě Azure SQL Database nastavte časový limit připojení na 30 sekund.
Aktuální jazyk - nebo - Jazyk	N/A	Nastaví jazyk používaný pro upozornění databázového serveru nebo chybové zprávy. Název jazyka může být 128 znaků nebo méně.
Zdroj dat - nebo - Server - nebo - Adresa - nebo - Addr - nebo - Síťová adresa	N/A	Název nebo síťová adresa instance SQL Serveru, ke které se chcete připojit. Číslo portu lze zadat za názvem serveru: server=tcp:servername, portnumber Při zadávání místní instance vždy používejte (místní). Pokud chcete vynutit použití protokolu, přidejte jednu z následujících předpon: np:(local), tcp:(local), lpc:(local) K databázi LocalDB se můžete připojit také takto: server=(localdb)\\myInstance Další informace o LocalDB naleznete v tématu Podpora SqlClient pro LocalDB. Zdroj dat musí používat formát TCP nebo pojmenované kanály. Formát TCP je následující: – tcp:<host name>\<instance name> – tcp:<host name>,< TCP/IP port number> Formát TCP musí začínat předponou "tcp:" a za ní následuje instance databáze, jak je určeno názvem hostitele a názvem instance. Tento formát se nedá použít při připojování ke službě Azure SQL Database. Protokol TCP je automaticky vybrán pro připojení ke službě Azure SQL Database, pokud není zadaný žádný protokol. Název hostitele musí být zadán jedním z následujících způsobů: - NetBIOSName – IPv4Address – IPv6Address Název instance se používá k překladu na konkrétní číslo portu TCP/IP, na kterém je hostovaná instance databáze. Případně můžete zadat přímo číslo portu TCP/IP. Pokud název instance i číslo portu nejsou k dispozici, použije se výchozí instance databáze. Formát Pojmenované kanály je následující: - np:\\<host name>\pipe\<pipe name> Formát Pojmenované kanály musí začínat předponou np:, za kterou následuje název pojmenovaného kanálu. Název hostitele musí být zadán jedním z následujících způsobů: - NetBIOSName – IPv4Address – IPv6Address Název kanálu slouží k identifikaci instance databáze, ke které se aplikace .NET připojí. Pokud je zadána hodnota síťového klíče, předpony "tcp:" a "np:" by neměly být zadány. Poznámka: Můžete vynutit použití protokolu TCP místo sdílené paměti, a to buď předponou tcp: na název serveru v připojovacím řetězci, nebo pomocí localhost.
Adresa URL ověření identity enklávy	N/A	Získá nebo nastaví adresu URL ověření identity enklávy, která se má použít s enklávou založenou na funkci Always Encrypted.
Šifrování	"true" ve verzi 4.0 a vyšší "false" v 3.x a níže	Rozpoznané hodnoty jsou: verze 1 – 4: true/yes a false/no verze 5+: trueyesmandatoryfalse//no//optional a .strict Pokud truese šifrování TLS používá pro všechna data odesílaná mezi klientem a serverem, pokud má server nainstalovaný certifikát. Pokud strictse použije šifrování TLS TDS 8.0 a TrustServerCertificate nastavení se ignoruje a považuje se za false. Další informace naleznete v tématu Syntaxe připojovacího řetězce. Pokud je Encryptmandatory nebo strict a TrustServerCertificate je false, musí název serveru (nebo IP adresa) v certifikátu serveru přesně odpovídat názvu serveru (nebo IP adrese) zadanému v připojovací řetězec. Jinak pokus o připojení selže.
Zařazení	'true'	true označuje, že nástroj pro sdružování připojení SQL Serveru automaticky zařadí připojení do aktuálního kontextu transakce vlákna pro vytvoření.
Partner s podporou převzetí služeb při selhání	N/A	Název partnerského serveru s podporou převzetí služeb při selhání, kde je nakonfigurované zrcadlení databáze. Pokud je hodnota tohoto klíče "", musí být k dispozici počáteční katalog a jeho hodnota nesmí být "". Název serveru může mít 128 znaků nebo méně. Pokud zadáte partnera pro převzetí služeb při selhání, ale partnerový server s podporou převzetí služeb při selhání není nakonfigurovaný pro zrcadlení databáze a primární server (zadaný klíčovým slovem Server) není dostupný, připojení se nezdaří. Pokud zadáte partnera pro převzetí služeb při selhání a primární server není nakonfigurovaný pro zrcadlení databáze, bude připojení k primárnímu serveru (zadanému klíčovým slovem Server) úspěšné, pokud je primární server dostupný.
Hlavní název služby partnera pro převzetí služeb při selhání - nebo - FailoverPartnerSPN	N/A	Hlavní název služby (SPN) partnera pro převzetí služeb při selhání. Výchozí hodnota je prázdný řetězec, který způsobí, že SqlClient použije výchozí hlavní název služby generované ovladačem. (K dispozici pouze ve verzi 5.0+)
Název hostitele v certifikátu - nebo - HostNameInCertificate	N/A	Název hostitele, který se má použít při ověřování certifikátu serveru. Pokud není zadaný, název serveru ze zdroje dat se použije k ověření certifikátu. (K dispozici pouze ve verzi 5.0+)
Certifikát serveru - nebo - ServerCertificate	N/A	Cesta k souboru certifikátu, který se má shodovat s certifikátem SQL Server TLS/SSL. Přijaté formáty certifikátů jsou PEM, DER a CER. Pokud je zadaný, zkontroluje se certifikát SQL Server ověřením, jestli zadaný certifikát ServerCertificate odpovídá přesné shodě. (K dispozici pouze ve verzi 5.1+)
Počáteční katalog - nebo - Databáze	N/A	Název databáze. Název databáze může mít 128 znaků nebo méně.
Integrované zabezpečení - nebo - Trusted_Connection	'false'	Pokud falseje v připojení zadáno ID uživatele a heslo. Pokud truese pro ověřování použijí aktuální přihlašovací údaje účtu Systému Windows. Rozpoznané hodnoty jsou true, , falseyes, noa sspi (důrazně doporučeno), což je ekvivalentní true. Pokud je zadáno ID uživatele a heslo a integrované zabezpečení je nastaveno na hodnotu true, BUDE ID uživatele a heslo ignorovány a bude použito integrované zabezpečení. SqlCredential je bezpečnější způsob, jak zadat přihlašovací údaje pro připojení, které používá ověřování SQL Serveru (Integrated Security=false).
Předvolba IP adres - nebo - IPAddressPreference	IPv4First	Předvolba rodiny IP adres při navazování připojení TCP. Pokud je Transparent Network IP Resolution (v .NET Framework) nebo Multi Subnet Failover nastavena na hodnotu true, toto nastavení nemá žádný vliv. Mezi podporované hodnoty patří: IPAddressPreference=IPv4First IPAddressPreference=IPv6First IPAddressPreference=UsePlatformDefault
Časový limit vyrovnávání zatížení - nebo - Životnost připojení	0	Když se připojení vrátí do fondu, jeho čas vytvoření se porovná s aktuálním časem a připojení se ukončí, pokud časové rozpětí (v sekundách) překročí hodnotu určenou Connection Lifetime. To je užitečné v clusterovaných konfiguracích k vynucení vyrovnávání zatížení mezi běžícím serverem a serverem, který jste právě převedli do režimu online. Hodnota nuly (0) způsobí, že připojení ve fondu mají maximální časový limit připojení.
Maximální velikost fondu	100	Maximální počet připojení, která jsou ve fondu povolená. Platné hodnoty jsou větší nebo rovny 1. Hodnoty, které jsou menší než minimální velikost fondu , generují chybu.
Minimální velikost fondu	0	Minimální počet připojení, která jsou ve fondu povolená. Platné hodnoty jsou větší nebo rovny 0. Nula (0) v tomto poli znamená, že se zpočátku neotevře žádná minimální připojení. Hodnoty větší než maximální velikost fondu generují chybu.
Více aktivních sad výsledků - nebo - MultipleActiveResultSets	false	Pokud truemůže aplikace udržovat více aktivních sad výsledků (MARS). Pokud falseaplikace musí zpracovat nebo zrušit všechny sady výsledků z jedné dávky, aby bylo možné v daném připojení spustit jakoukoli jinou dávku. Rozpoznané hodnoty jsou true a false. Další informace naleznete v tématu Více aktivních sad výsledků (MARS).
Převzetí služeb při selhání s více podsítě - nebo - MultiSubnetFailover	false	Při připojování k naslouchacímu procesu skupiny dostupnosti SQL Serveru 2012 (nebo novějšího) nebo instance clusteru s podporou převzetí služeb při selhání sql Serveru 2012 (nebo novějšího) vždy určete multiSubnetFailover=True . multiSubnetFailover=True nakonfiguruje SqlClient tak, aby poskytoval rychlejší detekci a připojení k (aktuálně) aktivnímu serveru. Možné hodnoty jsou Yes a NoTrue , a nebo False1 a a 0. Příklad: MultiSubnetFailover=True Výchozí hodnota je False. Další informace o podpoře Skupin dostupnosti AlwaysOn pro SqlClient najdete v tématu Podpora SqlClient pro vysokou dostupnost, zotavení po havárii.
Síťová knihovna - nebo - Síť - nebo - Čistý	N/A	Síťová knihovna používaná k navázání připojení k instanci SQL Serveru. Mezi podporované hodnoty patří: dbnmpntw (pojmenované kanály) dbmsrpcn (Multiprotocol, Windows RPC) dbmsadsn (Apple Talk) dbmsgnet (VIA) dbmslpcn (sdílená paměť) dbmsspxn (IPX/SPX) dbmssocn (TCP/IP) Dbmsvinn (Banyan Vines) Odpovídající síťová knihovna DLL musí být nainstalována v systému, ke kterému se připojujete. Pokud nezadáte síť a použijete místní server (například "." nebo "(local)"), použije se sdílená paměť. V tomto příkladu je síťová knihovna Win32 Winsock TCP/IP (dbmssocn) a 1433 je použitý port. Network Library=dbmssocn;Data Source=000.000.000.000,1433;
Velikost paketu	8 000	Velikost v bajtech síťových paketů používaných ke komunikaci s instancí SQL Serveru. Velikost paketu může být větší nebo rovna 512 a menší nebo rovna 32768.
Heslo - nebo - PWD	N/A	Heslo pro přihlášení k účtu SQL Serveru. Nedoporučuje se. Pokud chcete zachovat vysokou úroveň zabezpečení, důrazně doporučujeme místo toho použít Integrated Security klíčové slovo nebo Trusted_Connection klíčové slovo. SqlCredential je bezpečnější způsob, jak zadat přihlašovací údaje pro připojení, které používá ověřování SQL Serveru. Heslo musí obsahovat 128 znaků nebo méně.
Zachování bezpečnostních údajů - nebo - PersistSecurityInfo	'false'	Pokud je nastavená hodnota false nebo no (důrazně doporučeno), informace citlivé na zabezpečení, jako je heslo nebo přístupový token, se nevrátí jako součást připojení, pokud je připojení otevřené nebo je někdy v otevřeném stavu. Tato vlastnost by měla být nastavena true pouze v případě, že vaše aplikace potřebuje přečíst heslo z již otevřeného připojení k databázi. Výchozí hodnota false je bezpečnější nastavení. Použití true této vlastnosti otevře aplikaci na bezpečnostní rizika, jako je náhodné protokolování nebo trasování hesla databáze. Resetováním připojovacího řetězce se obnoví všechny hodnoty připojovacího řetězce včetně hesla. Rozpoznané hodnoty jsou true, false, yesa no.
Období blokování bazénu - nebo - Období blokování bazénu	Automaticky	Nastaví chování blokujícího období pro fond připojení. Podrobnosti PoolBlockingPeriod najdete v vlastnosti.
Sdružování	'true'	Pokud je hodnota tohoto klíče nastavena na hodnotu true, při zavření aplikace se do fondu přidá jakékoli nově vytvořené připojení. Při dalším pokusu o otevření stejného připojení bude toto připojení nakresleno z fondu. Připojení se považují za stejná, pokud mají stejný připojovací řetězec. Různá připojení mají různé připojovací řetězce. Hodnota tohoto klíče může být "true", "false", "yes" nebo "no".
Replication	'false'	true pokud se replikace podporuje pomocí připojení.
SPN serveru - nebo - ServerSPN	N/A	Hlavní název služby (SPN) pro zdroj dat. Výchozí hodnota je prázdný řetězec, který způsobí, že SqlClient použije výchozí hlavní název služby generované ovladačem. (K dispozici pouze ve verzi 5.0+)
Vazba transakce	Implicitní zrušení vazby	Řídí přidružení připojení k zařazené System.Transactions transakci. Možné hodnoty: Transaction Binding=Implicit Unbind; Transaction Binding=Explicit Unbind; Implicitní zrušení vazby způsobí odpojení připojení od transakce, když skončí. Po odpojení se v režimu automatického odesílání provádějí další požadavky na připojení. Vlastnost není kontrolována System.Transactions.Transaction.Current při provádění požadavků v době, kdy je transakce aktivní. Po ukončení transakce se v režimu automatickéhocommitu provádějí další požadavky. Pokud systém ukončí transakci (v oboru bloku using) před dokončením posledního příkazu, vyvolá InvalidOperationExceptionse . Explicitní zrušení vazby způsobí, že připojení zůstane připojeno k transakci, dokud není připojení uzavřeno nebo explicitní SqlConnection.TransactionEnlist(null) je volána. Počínaje .NET Framework 4.0 jsou změny implicitního zrušení vazby zastaralé. Je InvalidOperationException vyvolána, pokud Transaction.Current není zařazena transakce nebo pokud zařazení transakce není aktivní.
Transparentní řešení IP adres v síti - nebo - Transparentní síťové IP rozlišení	Viz popis.	Pokud je hodnota tohoto klíče nastavena truena , aplikace je nutná k načtení všech IP adres pro určitou položku DNS a pokus o připojení s prvním v seznamu. Pokud se připojení nenaváže během 0,5 sekund, aplikace se pokusí připojit ke všem ostatním paralelně. Při prvních odpovědích aplikace vytvoří spojení s IP adresou respondenta. MultiSubnetFailover Pokud je klíč nastavený na true, TransparentNetworkIPResolution bude ignorován. Failover Partner Pokud je klíč nastavený, TransparentNetworkIPResolution bude ignorován. Hodnota tohoto klíče musí být true, false, yesnebo no. Hodnota yes je považována za hodnotu true. Hodnota no je považována za hodnotu false. Výchozí hodnoty jsou: false Kdy: Připojení ke službě Azure SQL Database, kde zdroj dat končí: .database.chinacloudapi.cn .database.usgovcloudapi.net .database.cloudapi.de .database.windows.net .database.fabric.microsoft.com Authentication je "Heslo služby služba Active Directory" nebo "Integrované služby služba Active Directory". true ve všech ostatních případech.
Důvěřovat certifikátu serveru - nebo - TrustServerCertificate	'false'	Pokud je nastavená hodnota true, protokol TLS se používá k šifrování kanálu při obejití procházení řetězu certifikátů k ověření důvěryhodnosti. Pokud je vlastnost TrustServerCertificate nastavená na true hodnotu Encrypt false, kanál není šifrovaný. Rozpoznané hodnoty jsou true, false, yesa no. Další informace naleznete v tématu Syntaxe připojovacího řetězce.
Verze systému typů	N/A	Řetězcová hodnota, která označuje systém typů, který aplikace očekává. Funkce dostupné klientské aplikaci závisí na verzi SQL Serveru a na úrovni kompatibility databáze. Explicitní nastavení verze systému typů, kterou byla klientská aplikace napsána, aby se zabránilo potenciálním problémům, které by mohly způsobit přerušení aplikace v případě použití jiné verze SQL Serveru. Poznámka: Verzi systému typů nelze nastavit pro kód CLR (Common Language Runtime) spouštěný v procesu v SQL Serveru. Další informace naleznete v tématu SQL Server Common Language Runtime Integration. Možné hodnoty: Type System Version=SQL Server 2012; Type System Version=SQL Server 2008; Type System Version=SQL Server 2005; Type System Version=Latest; Type System Version=SQL Server 2012; určuje, že aplikace bude vyžadovat verzi 11.0.0.0 Microsoft.SqlServer.Types.dll. Ostatní Type System Version nastavení budou vyžadovat verzi 10.0.0.0 Microsoft.SqlServer.Types.dll. Latest je zastaralý a neměl by se používat. Latest je ekvivalent Type System Version=SQL Server 2008;.
ID uživatele - nebo - UID - nebo - Uživatel	N/A	Přihlašovací účet SQL Serveru. Nedoporučuje se. Pokud chcete zachovat vysokou úroveň zabezpečení, důrazně doporučujeme místo toho používat Integrated Security klíčová slova nebo Trusted_Connection klíčová slova. SqlCredential je bezpečnější způsob, jak zadat přihlašovací údaje pro připojení, které používá ověřování SQL Serveru. ID uživatele musí být 128 znaků nebo méně.
Instance uživatele	'false'	Hodnota, která určuje, jestli se má přesměrovat připojení z výchozí instance SQL Serveru Express na instanci spuštěnou za běhu spuštěnou pod účtem volajícího.
ID pracovní stanice - nebo - WSID	Název místního počítače	Název pracovní stanice, která se připojuje k SQL Serveru. ID musí být 128 znaků nebo méně.

Následující seznam obsahuje platné názvy pro hodnoty sdružování připojení v rámci souboru ConnectionString. Další informace najdete v tématu Sdružování připojení k SQL Serveru (ADO.NET).

• Životnost připojení (nebo vypršení časového limitu vyrovnávání zatížení)

• Zařazení

• Maximální velikost fondu

• Minimální velikost fondu

• Sdružování

Při nastavování hodnot klíčového slova nebo sdružování připojení, které vyžadují logickou hodnotu, můžete místo hodnoty true a ne false použít ano a ne ne. Celočíselné hodnoty jsou reprezentovány jako řetězce.

Note

Zprostředkovatel dat rozhraní .NET Framework pro SQL Server používá k komunikaci s SQL Serverem vlastní protokol. Proto nepodporuje použití názvu zdroje dat ODBC (DSN) při připojování k SQL Serveru, protože nepřidává vrstvu ODBC.

Note

Soubory univerzálního datového propojení (UDL) nejsou podporovány pro zprostředkovatele dat rozhraní .NET Framework pro SQL Server.

Upozornění

V této verzi by aplikace měla při vytváření připojovací řetězec na základě uživatelského vstupu používat upozornění (například při načítání ID uživatele a hesla z dialogového okna a jeho připojení k připojovací řetězec). Aplikace by se měla ujistit, že uživatel nemůže do těchto hodnot vložit další parametry připojovací řetězec (například zadání hesla jako validpassword; database=somedb" při pokusu o připojení k jiné databázi). Pokud potřebujete vytvořit připojovací řetězce na základě uživatelského vstupu, použijte nový SqlConnectionStringBuilder, který ověří připojovací řetězec a pomůže tento problém odstranit. Další informace najdete v tématu Tvůrci připojovacích řetězců .