SqlConnection.ConnectionString Vlastnost

Reference

Definice

Obor názvů:: System.Data.SqlClient

Sestavení:: System.Data.SqlClient.dll

Sestavení:: System.Data.dll

Balíček:: System.Data.SqlClient v4.8.6

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

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

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

public override string ConnectionString { get; set; }

[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
public string ConnectionString { get; set; }

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

member this.ConnectionString : string with get, set

[<System.Data.DataSysDescription("SqlConnection_ConnectionString")>]
member this.ConnectionString : string with get, set

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

Public Overrides Property ConnectionString As String

Public 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.

Implementuje

ConnectionString

Atributy: DataSysDescriptionAttribute SettingsBindableAttribute

Výjimky

ArgumentException

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

Příklady

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

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

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection()

        connection.ConnectionString = connectionString

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file.
    Return "Data Source=MSSQL1;Database=AdventureWorks;" _
      & "Integrated Security=true;"
End Function

Poznámky

Objekt ConnectionString je podobný připojovací řetězec OLE DB, ale není identický. Na rozdíl od OLE DB nebo ADO je vrácená připojovací řetězec stejná jako sada ConnectionStringuživatelů , po odečtení informací o zabezpečení, pokud je hodnota Zachovat informace o zabezpečení nastavená na false (výchozí). Zprostředkovatel dat rozhraní .NET Framework pro SQL Server nezachová ani nevrací heslo v připojovací řetězec, pokud nenastavíte Možnost Trvalé bezpečnostní údaje na truehodnotu .

Vlastnost můžete použít ConnectionString pro připojení k databázi. Následující příklad znázorňuje typickou připojovací řetězec.

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

K vytvoření platných připojovacích řetězců za běhu použijte nový SqlConnectionStringBuilder . Další informace najdete v tématu Tvůrce připojovacích řetězců.

Vlastnost ConnectionString lze nastavit pouze v případech, kdy je připojení ukončeno. Mnoho připojovací řetězec hodnot má odpovídající vlastnosti jen pro čtení. Při nastavení připojovací řetězec se tyto vlastnosti aktualizují s výjimkou případů, kdy se zjistí chyba. V tomto případě se neaktualizují žádné vlastnosti. SqlConnection vlastnosti vrátí pouze nastavení, která jsou obsažena 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 o připojení k výchozí instanci v místním počítači.

Při resetování ConnectionString u uzavřeného připojení se resetují všechny připojovací řetězec hodnoty (a související vlastnosti), včetně hesla. Pokud například nastavíte připojovací řetězec obsahující "Database= AdventureWorks" a potom resetujete připojovací řetězec na "Zdroj dat=myserver; Integrated Security=true, Database vlastnost už není nastavená 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 modulu runtime, například ArgumentException. Další chyby se dají najít jenom v případech, kdy dojde k pokusu o otevření připojení.

Základní formát připojovací řetězec zahrnuje řadu dvojic klíčového slova a hodnoty oddělených středníky. Symbol rovná se (=) spojuje jednotlivá klíčová slova 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 také užitečná, pokud hodnota začíná znakem dvojité uvozovky. Naopak dvojitou uvozovku lze použít, pokud hodnota začíná jednou uvozovkou. Pokud hodnota obsahuje znaky jednoduchých i dvojitých uvozovek, musí se znak uvozovek použitý k uzavření hodnoty při každém výskytu v hodnotě zdvojnásobit.

Pokud chcete do řetězcové hodnoty zahrnout předchozí nebo koncové mezery, musí být hodnota uzavřena v jednoduchých uvozovkách nebo v uvozovkách. Všechny počáteční nebo koncové mezery kolem celočíselné, logické nebo výčtové hodnoty jsou ignorovány, i když jsou uzavřeny v uvozovkách. Mezery v řetězcovém klíčovém slově nebo hodnotě literálu jsou však zachovány. Jednoduché nebo dvojité uvozovky lze použít v připojovací řetězec bez použití oddělovačů (například Zdroj dat= my'Server nebo Zdroj dat= my"Server), pokud je uvozovka prvním nebo posledním znakem v hodnotě.

U klíčových slov se nerozlišují velká a malá písmena.

V následující tabulce jsou uvedeny platné názvy hodnot klíčových slov v objektu ConnectionString.

Keyword	Výchozí	Description
Addr	–	Synonymum zdroje dat.
Adresa	–	Synonymum zdroje dat.
Aplikace	–	Synonymum názvu aplikace.
Název aplikace	–	Název aplikace nebo poskytovatel dat .NET SQLClient, pokud není zadaný žádný název aplikace. Název aplikace může být delší než 128 znaků.
`ApplicationIntent`	`ReadWrite`	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 najdete v tématu Podpora SqlClient pro vysokou dostupnost a zotavení po havárii.
Asynchronní zpracování -nebo- Async	False	Když `true`, povolí podporu asynchronních operací. Rozpoznané hodnoty jsou `true`, `falseyes`, a `no`. Tato vlastnost je ignorována počínaje rozhraním .NET Framework 4.5. Další informace o podpoře sqlClient pro asynchronní programování najdete v tématu Asynchronní programování.
Attachdbfilename -nebo- Rozšířené vlastnosti -nebo- Počáteční název souboru	–	Název primárního souboru databáze, včetně úplného názvu cesty k připojitelné databázi. AttachDBFilename je podporován pouze pro primární datové soubory s příponou .mdf. Pokud je v připojovací řetězec 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í zadán a databáze byla dříve připojena, databáze nebude znovu připojena. Dříve připojená databáze se použije jako výchozí databáze pro připojení. Pokud je tento klíč zadán společně s klíčem AttachDBFileName, použije se jako alias hodnota tohoto klíče. Pokud se však název již používá 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žívá DataDirectory, musí soubor databáze existovat v podadresáři adresáře, na který odkazuje náhradní řetězec. Poznámka: Názvy cest vzdáleného serveru, HTTP a UNC se nepodporují. 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"` Chyba se vygeneruje, pokud soubor protokolu existuje ve stejném adresáři jako datový soubor a při připojování primárního datového souboru se použije klíčové slovo "database". V takovém případě odeberte soubor protokolu. Po připojení databáze se na základě fyzické cesty automaticky vygeneruje nový soubor protokolu.
Authentication	–	Metoda ověřování používaná pro připojení k SQL Database pomocí ověřování Azure Active Directory. Platné hodnoty jsou: Integrovaná služba Active Directory, heslo služby Active Directory, heslo SQL.
Nastavení šifrování sloupců	–	Povolí nebo zakáže Always Encrypted funkce pro připojení.
Časový limit připojení -nebo- Časový limit připojení -nebo- Časový limit	15	Doba (v sekundách) čekání na připojení k serveru, než se pokus ukončí a vygeneruje chyba. Platné hodnoty jsou větší nebo rovné 0 a menší nebo rovno 2147483647. Při otevírání připojení k Azure SQL Database nastavte časový limit připojení na 30 sekund.
Doba života připojení -nebo- Vypršení časového limitu vyrovnávání zatížení	0	Když se připojení vrátí do fondu, porovná se čas jeho vytvoření s aktuálním časem a připojení se zničí, pokud tento časový rozsah (v sekundách) překročí hodnotu určenou parametrem `Connection Lifetime`. To je užitečné v clusterovaných konfiguracích k vynucení vyrovnávání zatížení mezi spuštěným serverem a serverem, který byl právě online. Hodnota nula (0) způsobí, že připojení ve fondu budou mít maximální časový limit.
ConnectRetryCount	1	Řídí počet pokusů o opětovné připojení poté, co klient identifikuje selhání nečinného připojení. Platné hodnoty jsou 0 až 255. Výchozí hodnota je 1. 0 znamená nepokoušejte se znovu připojit (zakažte odolnost připojení). Další informace o odolnosti připojení najdete v tématu Parametry .NET SqlConnection pro opakování připojení a Technický článek – Odolnost nečinných připojení.
ConnectRetryInterval	10	Určuje čas mezi každým opakovaným pokusem o připojení (ConnectRetryCount). Platné hodnoty jsou 1 až 60 sekund (výchozí=10) a použijí se po prvním pokusu o opětovné připojení. Když je zjištěno přerušené připojení, klient se okamžitě pokusí znovu připojit; jedná se o první pokus o opětovné připojení a dojde pouze v případě, že connectRetryCount je větší než 0. Pokud první pokus o opětovné připojení selže a hodnota ConnectRetryCount je větší než 1, klient čeká ConnectRetryInterval, aby zkusil druhý a další pokus o opětovné připojení. Další informace o odolnosti připojení najdete v tématu Parametry .NET SqlConnection pro opakování připojení a Technický článek – Odolnost nečinných připojení.
Kontextové připojení	"false"	`true`pokud by se mělo vytvořit připojení v průběhu procesu k SQL Server.
Aktuální jazyk -nebo- Jazyk	–	Nastaví jazyk používaný pro upozornění nebo chybové zprávy databázového serveru. Název jazyka může být delší než 128 znaků.
Zdroj dat -nebo- Server -nebo- Adresa -nebo- Addr -nebo- Síťová adresa	–	Název nebo síťová adresa instance SQL Server, 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 (local). Pokud chcete vynutit protokol, přidejte jednu z následujících předpon: `np:(local), tcp:(local), lpc:(local)` Počínaje rozhraním .NET Framework 4.5 se můžete také připojit k databázi LocalDB následujícím způsobem: `server=(localdb)\\myInstance` Další informace o LocalDB najdete v tématu Podpora SqlClient pro LocalDB. Zdroj dat musí používat formát TCP nebo formát Pojmenované kanály. Formát TCP je následující: – tcp:<název> hostitele\<název instance> – tcp:<název> hostitele,číslo< portu TCP/IP> Formát TCP musí začínat předponou "tcp:" a za ním následuje instance databáze podle názvu hostitele a názvu instance. Tento formát se nedá použít při připojování ke službě Azure SQL Database. Pokud není zadaný žádný protokol, je pro připojení k databázi Azure SQL automaticky vybrán protokol TCP. 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. Další možností je zadat číslo portu TCP/IP přímo. Pokud název instance a číslo portu nejsou k dispozici, použije se výchozí instance databáze. Formát Pojmenované kanály je následující: – np:\\<název> hostitele\pipe\<název kanálu> Formát pojmenovaných kanálů MUSÍ začínat předponou "np:" a za ním 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é bude připojena aplikace rozhraní .NET Framework. Pokud je zadána hodnota síťového klíče, neměly by být zadány předpony "tcp:" a "np:". Poznámka: Použití protokolu TCP místo sdílené paměti můžete vynutit tak, že před název serveru v připojovací řetězec přidáte předponu tcp: nebo použijete localhost.
Encrypt	"false"	Pokud `true`je na serveru nainstalovaný certifikát, SQL Server použije šifrování SSL pro všechna data odesílaná mezi klientem a serverem. Rozpoznané hodnoty jsou `true`, `false`, `yes`a `no`. Další informace najdete v tématu Syntaxe připojovacího řetězce. Počínaje rozhraním .NET Framework 4.5 platí, že `TrustServerCertificate` pokud je hodnota false a `Encrypt` má hodnotu true, musí se název serveru (nebo IP adresa) v SQL Server certifikátu SSL přesně shodovat s názvem serveru (nebo IP adresou) zadaným v připojovací řetězec. Jinak se pokus o připojení nezdaří.
Zařazení	True	`true`označuje, že nástroj pro sdružování připojení SQL Server automaticky zařadí připojení do aktuálního kontextu transakce vlákna vytváření.
Partner pro převzetí služeb při selhání	–	Název partnerského serveru s podporou převzetí služeb při selhání, na kterém je nakonfigurované zrcadlení databáze. Pokud je hodnota tohoto klíče "", musí existovat počáteční katalog a jeho hodnota nesmí být "". Název serveru může být delší než 128 znaků. Pokud zadáte partnera pro převzetí služeb při selhání, ale partner pro převzetí služeb při selhání není nakonfigurovaný pro zrcadlení databáze a primární server (zadaný pomocí klíčového slova 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, připojení k primárnímu serveru (zadanému pomocí klíčového slova Server) bude úspěšné, pokud je primární server dostupný.
Počáteční katalog -nebo- Databáze	–	Název databáze. Název databáze může být delší než 128 znaků.
Integrované zabezpečení -nebo- Trusted_Connection	"false"	Když `false`se v připojení zadají ID uživatele a Heslo. Při `true`ověřování se použijí přihlašovací údaje k aktuálnímu účtu systému Windows. Rozpoznané hodnoty jsou `true`, `false`, `yes`, `no`a `sspi` (důrazně doporučujeme), což odpovídá hodnotě `true`. Pokud je zadáno ID uživatele a heslo a integrované zabezpečení je nastaveno na true, ID uživatele a heslo budou ignorovány a bude použito integrované zabezpečení. SqlCredentialje bezpečnější způsob, jak zadat přihlašovací údaje pro připojení, které používá ověřování SQL Server (`Integrated Security=false`).
Maximální velikost fondu	100	Maximální počet připojení, která jsou ve fondu povolená. Platné hodnoty jsou větší nebo rovné 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 rovné 0. Nula (0) v tomto poli znamená, že se na začátku neotevře žádná minimální připojení. Hodnoty, které jsou větší než Maximální velikost fondu , vygenerují chybu.
MultipleActiveResultSets	"false"	Když `true`, aplikace může udržovat více aktivních sad výsledků (MARS). Když `false`, aplikace musí zpracovat nebo zrušit všechny sady výsledků z jedné dávky, aby v daném připojení mohly spustit jakoukoli jinou dávku. Rozpoznané hodnoty jsou `true` a `false`. Další informace najdete v tématu Mars (Multiple Active Result Sets).
`MultiSubnetFailover`	FALSE	Vždy zadejte `multiSubnetFailover=True` při připojování k naslouchacímu procesu skupiny dostupnosti SQL Server 2012 (nebo novější) nebo SQL Server 2012 (nebo novější) instanci clusteru s podporou převzetí služeb při selhání. `multiSubnetFailover=True` nakonfiguruje SqlClient tak, aby poskytoval rychlejší detekci a připojení k (aktuálně) aktivnímu serveru. Možné hodnoty jsou `Yes` a `No`, `True` a `False` nebo `1` a .`0` Příklad: `MultiSubnetFailover=True` Výchozí formát je `False`. Další informace o podpoře skupin dostupnosti AlwaysOn služby SqlClient najdete v tématu Podpora sqlClient pro vysokou dostupnost a zotavení po havárii.
Síťová knihovna -nebo- Síť -nebo- Čisté	–	Síťová knihovna používaná k navázání připojení k instanci SQL Server. 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) V systému, ke kterému se připojujete, musí být nainstalována odpovídající síťová knihovna DLL. Pokud nezadáte síť a použijete místní server (například ." nebo (místní)), použije se sdílená paměť. V tomto příkladu je síťová knihovna Win32 Winsock TCP/IP (dbmssocn) a port 1433 je použitý. `Network Library=dbmssocn;Data Source=000.000.000.000,1433;`
Velikost paketu	8000	Velikost síťových paketů používaných ke komunikaci s instancí SQL Server v bajtech. Velikost paketu může být větší nebo rovna 512 a menší nebo rovna 32768.
Heslo -nebo- PWD	–	Heslo pro přihlášení účtu SQL Server. 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` . SqlCredentialje bezpečnější způsob, jak zadat přihlašovací údaje pro připojení, které používá ověřování SQL Server. Heslo musí mít minimálně 128 znaků.
Zachování bezpečnostních údajů -nebo- PersistSecurityInfo	"false"	Pokud je nastavená hodnota `false` nebo `no` (důrazně doporučujeme), informace citlivé na zabezpečení, jako je například heslo, se jako součást připojení nevrátí, pokud je připojení otevřené nebo bylo v otevřeném stavu. Při resetování připojovací řetězec se resetují všechny připojovací řetězec hodnoty včetně hesla. Rozpoznané hodnoty jsou `true`, `false`, `yes`a `no`.
PoolBlockingPeriod	Auto	Nastaví chování blokující doby pro fond připojení. Podrobnosti najdete v části PoolBlockingPeriod vlastnost.
Sdružování	True	Pokud je hodnota tohoto klíče nastavená na true, při zavření aplikací se do fondu přidají všechna nově vytvořená připojení. Při dalším pokusu o otevření stejného připojení bude toto připojení převzato z fondu. Connections se považují za stejné, pokud mají stejnou 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 "ne".
Replikace	"false"	`true` pokud se replikace podporuje pomocí připojení.
Vazba transakce	Implicitní zrušení vazby	Řídí přidružení připojení s zařazenou `System.Transactions` transakcí. 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 další požadavky na připojení provádějí v režimu automatického připojení. Vlastnost `System.Transactions.Transaction.Current` není kontrolována při provádění požadavků v době, kdy je transakce aktivní. Po dokončení transakce se další požadavky provedou v režimu automatického přijetí. Pokud systém ukončí transakci (v rozsahu bloku using) před dokončením posledního příkazu, vyvolá InvalidOperationException. Explicitní Zrušení vazby způsobí, že připojení zůstane připojeno k transakci, dokud připojení není uzavřen nebo explicitní `SqlConnection.TransactionEnlist(null)` je volána. Počínaje rozhraním .NET Framework 4 změny implicitního zrušení vazby zastarávají explicitní zrušení vazby. Je `InvalidOperationException` vyvolána, pokud `Transaction.Current` není zařazena transakce nebo pokud zařazená transakce není aktivní.
TransparentNetworkIPResolution	Viz popis.	Pokud je hodnota tohoto klíče nastavená na `true`, musí aplikace načíst všechny IP adresy pro určitou položku DNS a pokusit se připojit k první z nich v seznamu. Pokud se připojení nenaváže do 0,5 sekundy, aplikace se pokusí připojit ke všem ostatním paralelně. Při prvních odpovědích aplikace naváže spojení s IP adresou respondenta. `MultiSubnetFailover` Pokud je klíč nastavený na `true`hodnotu , `TransparentNetworkIPResolution` bude ignorován. `Failover Partner` Pokud je klíč nastavený, `TransparentNetworkIPResolution` bude ignorován. Hodnota tohoto klíče musí být `true`, `false`, `yes`nebo `no`. Hodnota je `yes` považována za stejnou jako hodnotu `true`. Hodnota je `no` považována za stejnou jako hodnotu `false`. Výchozí hodnoty jsou následující: `false` Kdy: Připojení k Azure SQL Database, kde zdroj dat končí na: .database.chinacloudapi.cn .database.usgovcloudapi.net .database.cloudapi.de .database.windows.net `Authentication` je "Heslo služby Active Directory" nebo "Integrované služby Active Directory". `true` ve všech ostatních případech.
TrustServerCertificate	False	Pokud je nastavená hodnota `true`, použije se ssl k šifrování kanálu při obejití řetězce certifikátů za účelem ověření důvěryhodnosti. Pokud je hodnota TrustServerCertificate nastavená na `true` a možnost Šifrovat je nastavená na `false`, kanál není zašifrovaný. Rozpoznané hodnoty jsou `true`, `falseyes`, a `no`. Další informace najdete v tématu Syntaxe připojovacího řetězce.
Typ verze systému	–	Řetězcová hodnota označující systém typů, který aplikace očekává. Funkce dostupné pro klientskou aplikaci závisí na verzi SQL Server a úrovni kompatibility databáze. Explicitní nastavení verze systému typu, pro kterou byla klientská aplikace napsaná, se vyhne potenciálním problémům, které by mohly způsobit přerušení aplikace, pokud se použije jiná verze SQL Server. Poznámka: Verzi systému typu nelze nastavit pro kód CLR (Common Language Runtime) spouštěný v procesu v SQL Server. Další informace najdete v tématu SQL Server integrace prostředí Common Language Runtime. 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 ekvivalentem k `Type System Version=SQL Server 2008;`.
ID uživatele -nebo- UID -nebo- Uživatel	–	Přihlašovací účet SQL Server. Nedoporučuje se. Pokud chcete zachovat vysokou úroveň zabezpečení, důrazně doporučujeme použít `Integrated Security` klíčová slova nebo `Trusted_Connection` . SqlCredentialje bezpečnější způsob, jak zadat přihlašovací údaje pro připojení, které používá ověřování SQL Server. ID uživatele musí být delší než 128 znaků.
Instance uživatele	False	Hodnota, která označuje, zda se má přesměrovat připojení z výchozí instance SQL Server Express na instanci iniciovanou modulem runtime 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 Server. ID musí mít nejvýše 128 znaků.

Následující seznam obsahuje platné názvy pro hodnoty sdružování připojení v rámci ConnectionString. Další informace najdete v tématu SQL Server sdružování připojení (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í

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

Poznámka

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

Poznámka

Soubory UDL (Universal Data Link) nejsou podporovány pro zprostředkovatele dat rozhraní .NET Framework pro SQL Server.

Upozornění

V této verzi by měla aplikace při vytváření připojovací řetězec na základě vstupu uživatele (například při načítání id uživatele a informací o hesle z dialogového okna a jejich připojení k připojovací řetězec) postupovat opatrně. 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 zadat heslo 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ě vstupu uživatele, použijte novou SqlConnectionStringBuilder, která ověří připojovací řetězec a pomůže tento problém odstranit. Další informace najdete v tématu Tvůrce připojovacích řetězců .

Platí pro