Sdílet prostřednictvím


SqlConnection.ConnectionString Vlastnost

Definice

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); };
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
public override string ConnectionString { get; set; }
[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set
member this.ConnectionString : string with get, set
Public Overrides Property ConnectionString As String

Hodnota vlastnosti

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

Výjimky

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

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

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.
Záměr aplikace

-nebo-

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.
Název aplikace Název aplikace Pokud není zadaný žádný název aplikace, "Framework Microsoft SqlClient Data Provider" při spuštění v rozhraní .NET Framework a 'Core Microsoft SqlClient Data Provider' v opačném případě.

Název aplikace může být delší než 128 znaků.
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.
Protokol ověření identity Notspecified Získá nebo nastaví hodnotu attestation Protocol.

Pokud není zadána žádná hodnota, zabezpečené enklávy jsou pro připojení zakázané.

Platné hodnoty jsou:
AAS
HGS
None (Platí pouze ve verzi 3.1 a v4.1+))
Authentication Metoda ověřování používaná pro připojení k SQL Database pomocí ověřování Azure Active Directory.

Platné hodnoty jsou:

Active Directory Integrated, Active Directory Interactive, Active Directory Password, Active Directory Service Principal, Active Directory Device Code Flow, Active Directory Managed Identity, Active Directory MSI, Active Directory Default, Sql Password.

Další informace najdete v tématu Použití ověřování Azure Active Directory s SqlClient.
Nastavení šifrování sloupců zakázaný Povolí nebo zakáže Always Encrypted funkce 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ší nebo roven 0 a menší nebo rovno 2147483647.
Připojit počet opakování

-nebo-

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. 0 znamená, že se nepokoušejte se znovu připojit (zakažte odolnost připojení).

Poznámka: Od verze 5.x je výchozí hodnota pro koncové body mimo Azure 1. U Azure SQL koncových bodů je výchozí hodnota 2. Pro Azure SQL bezserverových koncových bodů nebo koncových bodů na vyžádání je výchozí hodnota 5 pro zlepšení úspěšnosti připojení k nečinné nebo pozastavené instanci.

Další informace o odolnosti nečinných připojení najdete v tématu Parametry .NET SqlConnection pro opakování připojení a technický článek – Odolnost nečinných připojení.
Interval opakování připojení

-nebo-

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) použité po prvním pokusu o opětovné připojení. Při zjištění přerušeného připojení se klient okamžitě pokusí o opětovné připojení. 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 , aby zkusil druhý a další pokus o opětovné připojení.

Další informace o odolnosti nečinných připojení najdete v tématech .NET SqlConnection parameters for connection retry and Technical Article – Odolnost nečinných připojení.
Časový limit připojení

-nebo-

Časový limit připojení

-nebo-

Časový limit
15 Doba čekání na připojení k serveru (v sekundách) před ukončením pokusu a vygenerováním chyby

Platné hodnoty jsou větší nebo roven 0 a menší nebo rovno 2147483647.

Při otevírání připojení k databázi Azure SQL nastavte časový limit připojení na 30 sekund.
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žijte (místní). Pokud chcete vynutit protokol, přidejte jednu z následujících předpon:

np:(local), tcp:(local), lpc:(local)

K databázi LocalDB se také můžete připojit 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 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í k Azure SQL Database. Pro připojení k databázi Azure SQL je automaticky vybrán protokol TCP, 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ě je možné zadat číslo portu TCP/IP přímo. Pokud název instance ani číslo portu nejsou k dispozici, použije se výchozí instance databáze.

Formát pojmenovaných kanálů je následující:

- np:\\<název> hostitele\pipe\<název kanálu>

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 bude aplikace .NET připojovat.

Pokud je zadána hodnota síťového klíče, neměly by být zadány předpony "tcp:" a "np:". Poznámka: Místo sdílené paměti můžete vynutit použití protokolu TCP, a to buď zadáním předpony tcp: k názvu serveru v připojovací řetězec, nebo pomocí localhost.
Adresa URL ověření identity enklávy Získá nebo nastaví adresu URL ověření identity enklávy pro použití s enklávy založené Always Encrypted.
Encrypt "true" ve 4.0 a vyšších verzích

False ve 3.x a nižší
Rozpoznané hodnoty jsou:
verze 1 až 4: true/yes a false/no
verze 5+: truemandatory/yes/, falseno//optional a .strict Pokud trueje na serveru nainstalovaný certifikát, použije se šifrování TLS pro všechna data odesílaná mezi klientem a serverem. Když strictse použije šifrování TDS 8.0 TLS a TrustServerCertificate nastavení se ignoruje a považuje se za nepravdivé. Další informace najdete v tématu Syntaxe připojovacího řetězce.

Pokud Encrypt je mandatory nebo strict je TrustServerCertificatefalse, musí se název serveru (nebo IP adresa) v certifikátu serveru přesně shodovat s názvem serveru (nebo IP adresou) zadaným v připojovací řetězec. V opačném případě se pokus o připojení nezdaří.
Zařazení "true" trueoznač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 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í být k dispozici 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 s podporou převzetí služeb při selhání, ale na partnerském serveru s podporou převzetí služeb při selhání není nakonfigurováno zrcadlení databáze a primární server (zadaný pomocí klíčového slova Server) nebude k dispozici, připojení selže.

Pokud zadáte partnera pro převzetí služeb při selhání a primární server není nakonfigurován 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 k dispozici.
Hlavní název služby partnera pro převzetí služeb při selhání

-nebo-

FailoverPartnerSPN
Hlavní název služby (SPN) partnera pro převzetí služeb při selhání. Výchozí hodnota je prázdný řetězec, což způsobí, že SqlClient použije výchozí hlavní název služby (SPN) vygenerovaný ovladačem.

(K dispozici pouze ve verzi 5.0+)
Název hostitele v certifikátu

-nebo-

HostNameInCertificate
Název hostitele, který se má použít při ověřování certifikátu serveru. Pokud nezadáte název serveru ze zdroje dat, použije se k ověření certifikátu.

(K dispozici pouze ve verzi 5.0+)
Certifikát serveru

-nebo-

ServerCertificate
Cesta k souboru certifikátu, který se má shodovat s SQL Server certifikátEM TLS/SSL. Akceptované formáty certifikátů jsou PEM, DER a CER. Pokud je zadaný, zkontroluje se certifikát SQL Server ověřením, jestli se zadaný certifikát serveru přesně shoduje.

(K dispozici pouze ve verzi 5.1+)
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ž falsese v připojení zadají ID uživatele a Heslo. Při trueověřování se použijí přihlašovací údaje k aktuálnímu účtu systému Windows.

Rozpoznané hodnoty jsou true, false, yes, noa 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).
Předvolba IP adresy

-nebo-

IpAddressPreference
IPv4First Předvolba řady IP adres při navazování připojení TCP. Pokud Transparent Network IP Resolution (v rozhraní .NET Framework) nebo Multi Subnet Failover je nastavena na hodnotu true, nemá toto nastavení žádný vliv. Mezi podporované hodnoty patří:

IPAddressPreference=IPv4First

IPAddressPreference=IPv6First

IPAddressPreference=UsePlatformDefault
Vypršení časového limitu vyrovnávání zatížení

-nebo-

Doba života připojení
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.
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.
Více aktivních sad výsledků

-nebo-

MultipleActiveResultSets
false (nepravda) 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).
Převzetí služeb při selhání s více podsítě

-nebo-

MultiSubnetFailover
false (nepravda) 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 rovno 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, abyste místo toho použili 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 nejvýše 128 znaků.
Zachování bezpečnostních údajů

-nebo-

PersistSecurityInfo
False Pokud je nastavená hodnota nebo no (důrazně doporučujeme), informace citlivé na false zabezpečení, jako je heslo nebo přístupový token, se nevrátí jako součást připojení, pokud je připojení otevřené nebo kdy bylo v otevřeném stavu. Tato vlastnost by měla být nastavena na true hodnotu 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 rizikům zabezpečení, jako je náhodné protokolování nebo trasování hesla databáze.

Při resetování připojovací řetězec se resetují všechny připojovací řetězec hodnoty včetně hesla. Rozpoznané hodnoty jsou true, falseyes, a no.
Období blokování fondu

-nebo-

PoolBlockingPeriod
Auto Nastaví chování období blokování pro fond připojení. Podrobnosti najdete PoolBlockingPeriod v části vlastnost.
Sdružování "true" Pokud je hodnota tohoto klíče nastavená na hodnotu 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í se toto připojení nakreslí 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 pomocí připojení podporuje replikace.
Hlavní název služby (SPN) serveru

-nebo-

ServerSPN
Hlavní název služby 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 (SPN) vygenerovaný ovladačem.

(K dispozici pouze ve verzi 5.0 a novější)
Vazba transakce Implicitní zrušení vazby Řídí přidružení připojení s transakcí zařazenou System.Transactions do seznamu.

Možné hodnoty:

Transaction Binding=Implicit Unbind;

Transaction Binding=Explicit Unbind;

Implicitní zrušení vazby způsobí odpojení připojení od transakce, jakmile skončí. Po odpojení se další požadavky na připojení provádějí v režimu automatického spojení. Vlastnost System.Transactions.Transaction.Current není kontrolována při provádění požadavků, zatímco transakce je aktivní. Po dokončení transakce se další požadavky provádějí v režimu automatického odeslání.

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řeno nebo je volána explicitní SqlConnection.TransactionEnlist(null) . Počínaje rozhraním .NET Framework 4.0 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 není aktivní.
Transparentní překlad IP adres sítě

-nebo-

TransparentNetworkIPResolution
Viz popis. Pokud je hodnota tohoto klíče nastavená na true, aplikace musí načíst všechny IP adresy pro konkrétní položku DNS a pokusit se připojit k první z nich v seznamu. Pokud se připojení nenaváže během 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 truehodnotu , 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 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.
Důvěřovat certifikátu serveru

-nebo-

TrustServerCertificate
False Pokud je nastavená hodnota true, protokol TLS se použije 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