SqlConnection.ConnectionString Vlastnost

Definice

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

Sestavení:: System.Data.SqlClient.dll

Sestavení:: System.Data.dll

Zdroj:: System.Data.SqlClient.notsupported.cs

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í databáze SQL Serveru.

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

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

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
`Address`	N/A	Synonymum zdroje dat
`App`	N/A	Synonymum názvu aplikace
`Application Name`	N/A	Název aplikace nebo .NET SQLClient Data Provider, pokud není zadaný žádný název aplikace. Název aplikace může mít 128 znaků nebo méně.
`ApplicationIntent`	`ReadWrite`	Deklaruje typ úlohy aplikace při připojování k serveru. Možné hodnoty jsou `ReadOnly` a `ReadWrite`. Napří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.
`Asynchronous Processing` nebo `Async`	'false'	Když `true`povolí podporu asynchronních operací. Rozpoznané hodnoty jsou `true`, `false`, `yes`a `no`. Tato vlastnost je ignorována od rozhraní .NET Framework 4.5. Další informace o podpoře SqlClient pro asynchronní programování naleznete v tématu Asynchronní programování.
`AttachDBFilename` nebo `Extended Properties` nebo `Initial File Name`	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.
`Authentication`	N/A	Metoda ověřování používaná pro připojení ke službě SQL Database pomocí ověřování Azure Active Directory. Platné hodnoty jsou: Integrované služby Active Directory, heslo služby Active Directory, heslo SQL.
`Column Encryption Setting`	N/A	Povolí nebo zakáže funkci Always Encrypted pro připojení.
`Connect Timeout` nebo `Connection Timeout` nebo `Timeout`	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.
`Connection Lifetime` nebo `Load Balance Timeout`	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í.
`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. Výchozí hodnota je 1. 0 znamená, že se nepokoušejte 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 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 dojde 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 čeká ConnectRetryInterval a pokusí se zkusit druhý a následné pokusy 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í.
`Context Connection`	'false'	`true` Pokud by mělo být provedeno připojení v procesu k SQL Serveru.
`Current Language` nebo `Language`	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ě.
`Data Source` nebo `Server` nebo `Address` nebo `Addr` nebo `Network Address`	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)` Počínaje rozhraním .NET Framework 4.5 se také můžete připojit k databázi LocalDB následujícím způsobem: `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é bude aplikace rozhraní .NET Framework připojena. 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.
`Encrypt`	'false'	Pokud `true`sql Server používá šifrování SSL pro všechna data odesílaná mezi klientem a serverem, pokud má server nainstalovaný certifikát. Rozpoznané hodnoty jsou `true`, `false`, `yes`a `no`. Další informace naleznete v tématu Syntaxe připojovacího řetězce. Počínaje rozhraním .NET Framework 4.5 musí `TrustServerCertificateEncrypt` název serveru (nebo IP adresa) v certifikátu SSL SQL Serveru přesně odpovídat názvu serveru (nebo IP adrese) zadanému v připojovacím řetězci. Jinak pokus o připojení selže.
`Enlist`	"pravda"	`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í.
`Failover Partner`	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ý.
`Initial Catalog` nebo `Database`	N/A	Název databáze. Název databáze může mít 128 znaků nebo méně.
`Integrated Security` nebo `Trusted_Connection`	'false'	Pokud `false`je v připojení zadáno ID uživatele a heslo. Pokud `true`se pro ověřování použijí aktuální přihlašovací údaje účtu Systému Windows. Rozpoznané hodnoty jsou `true`, , `falseyes`, `no`a `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`).
`Max Pool Size`	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.
`Min Pool Size`	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.
`MultipleActiveResultSets`	'false'	Pokud `true`může aplikace udržovat více aktivních sad výsledků (MARS). Pokud `false`aplikace 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).
`MultiSubnetFailover`	NEPRAVDA	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 `1False` a a `0`. Napří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.
`Network Library` nebo `Network` nebo `Net`	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;`
`Packet Size`	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.
`Password` 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ě.
`Persist Security Info` nebo `PersistSecurityInfo`	'false'	Pokud je nastavená `false` hodnota nebo `no` (důrazně doporučeno), informace citlivé na zabezpečení, jako je heslo, se nevrátí jako součást připojení, pokud je připojení otevřené nebo je někdy v otevřeném stavu. 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`, `yes`a `no`.
`PoolBlockingPeriod`	Auto	Nastaví chování blokujícího období pro fond připojení. Podrobnosti PoolBlockingPeriod najdete v vlastnosti.
`Pooling`	"pravda"	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í.
`Transaction Binding`	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 rozhraním .NET Framework 4 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í.
`TransparentNetworkIPResolution`	Viz popis.	Pokud je hodnota tohoto klíče nastavena `true`na , 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`, `yes`nebo `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 `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`, ssl 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`, `yes`a `no`. Další informace naleznete v tématu Syntaxe připojovacího řetězce.
`Type System Version`	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;`.
`User ID` nebo `UID` nebo `User`	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ě.
`User Instance`	'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.
`Workstation ID` 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).

Connection Lifetime (nebo Load Balance Timeout)
Enlist
Max Pool Size
Min Pool Size
Pooling

Když nastavíte klíčové slovo nebo hodnoty sdružování připojení, které vyžadují logickou hodnotu, můžete místo yestrueno a místo .false Celočíselné hodnoty jsou reprezentovány jako řetězce.

Poznámka:

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.

Poznámka:

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

Upozornění

Při vytváření připojovacího řetězce na základě uživatelského vstupu (například při načítání ID uživatele a informací o hesle z dialogového okna a jeho připojení k připojovacímu řetězci) buďte opatrní. Ujistěte se, že uživatel nemůže do těchto hodnot vložit další parametry připojovacího řetězce (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 SqlConnectionStringBuilder, který ověří připojovací řetězec a pomůže odstranit tento problém. Další informace naleznete v tématu Tvůrci řetězců připojení.

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?