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); };
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 obsahující 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

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

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í řetězec OLE DB, ale není identický. Na rozdíl od OLE DB nebo ADO je vrácená připojovací řetězec stejná jako uživatelská sada ConnectionString, minus bezpečnostní informace, pokud je hodnota Trvalé informace o zabezpečení nastavená na false (výchozí). Rozhraní .NET Framework Zprostředkovatel dat pro SQL Server neuchová ani nevrací heslo v připojovací řetězec, 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 typickou 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 najdete v tématu Tvůrce připojovacích řetězců.

Vlastnost ConnectionString lze nastavit pouze v případě, že je připojení uzavřeno. Mnoho hodnot připojovací řetězec mají odpovídající vlastnosti jen pro čtení. Při nastavení připojovací řetězec se tyto vlastnosti aktualizují s výjimkou zjištění chyby. V tomto případě se neaktualizují žádné vlastnosti. SqlConnection vlastnosti vrací pouze nastavení obsažená v souboru 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 na místním počítači.

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

Připojovací řetězec se parsuje hned po nastavení. Pokud při analýze dojde k chybám v syntaxi, vygeneruje se výjimka modulu runtime, například ArgumentException. Další chyby lze najít pouze v případě, že se pokusíte otevřít připojení.

Základní formát připojovací řetězec zahrnuje řadu párů klíčových slov a hodnot oddělených středníky. Znaménko rovná se (=) spojuje každé klíčové slovo a jeho hodnotu. Chcete-li zahrnout hodnoty obsahující 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á znakem dvojité uvozovky. Naopak dvojitá uvozovka se dá použít, pokud hodnota začíná jednou uvozovkou. Pokud hodnota obsahuje znaky jednoduché uvozovky i dvojité uvozovky, musí být znak uvozovky použitý k uzavření hodnoty poklikán při každém výskytu hodnoty.

Chcete-li zahrnout předchozí nebo koncové mezery do řetězcové hodnoty, musí být hodnota uzavřena do jednoduchých uvozovek nebo dvojitých uvozovek. Všechny počáteční nebo koncové mezery kolem celých čísel, logických hodnot nebo výčtu se ignorují, i když jsou uzavřeny v uvozovkách. Mezery v řetězcovém literálovém klíčovém slově nebo hodnotě se ale zachovají. Jednoduché nebo dvojité uvozovky lze použít v rámci připojovací řetězec bez použití oddělovačů (například Zdroj dat= my'Server nebo Zdroj dat= my"Server), pokud je uvozovka znakem první nebo poslední znak hodnoty.

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 souboru ConnectionString.

Klíčové slovo Výchozí Popis
Addr Synonymum zdroje dat
Adresa Synonymum zdroje dat
Aplikace Synonymum názvu aplikace
Název aplikace Název aplikace nebo .NET SQLClient Zprostředkovatel dat, pokud není zadaný žádný název aplikace.

Název aplikace může bý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. 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.
Asynchronní zpracování

-nebo-

Async
"false" Když truepovolíte podporu asynchronních operací. Rozpoznané hodnoty jsou true, false, yesa no.

Tato vlastnost se ignoruje 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-

Rozšířené vlastnosti

-nebo-

Počáteční název souboru
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í ř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 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 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 už používá v jiné připojené databázi, připojení selže.

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 ř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=&#124;DataDirectory&#124;\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 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 Metoda ověřování použitá 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 funkce Always Encrypted připojení.
vypršení časového limitu Připojení

-nebo-

Časový limit připojení

-nebo-

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

Platné hodnoty jsou větší nebo rovny 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.
Životnost připojení

-nebo-

Časový limit vyrovnávání zatížení
0 Když se připojení vrátí do fondu, porovná se jeho čas vytvoření s aktuálním časem a připojení se zničí, pokud toto časové období (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 spuštěným serverem a serverem, který jste právě přenesli do režimu online.

Hodnota nuly (0) způsobí, že připojení ve fondu budou mít maximální časový limit připojení.
ConnectRetryCount 1 Určuje počet pokusů o opětovné připojení po identifikaci nečinného připojení. Platné hodnoty jsou 0 až 255. Výchozí hodnota je 1. 0 znamená, že se nepokoušejte se znovu připojit (zakažte odolnost připojení).

Další informace o odolnosti nečinných připojení najdete v technickém článku – 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 (default=10), použité 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, aby se pokusil druhý a následné pokusy o opětovné připojení.

Další informace o odolnosti nečinných připojení najdete v technickém článku – Odolnost nečinných připojení.
Kontextové připojení "false" truepokud by mělo být provedeno připojení v procesu k SQL Server.
Aktuální jazyk

-nebo-

Jazyk
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á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 (místní). 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 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>\ název instance<>
- tcp:<host name>,<TCP/IP port number>

Formát TCP musí začínat předponou tcp:, za kterou 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í k Azure SQL Database. Protokol TCP se pro připojení k Azure SQL Database automaticky vybere, 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 instance databáze hostovaná. Případně můžete zadat číslo portu TCP/IP přímo. 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:\\<název> hostitele\název kanálu<kanálu\>

Formát Pojmenované kanály musí začínat předponou "np:" a následuje pojmenovaný název 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í řetězec, nebo pomocí localhost.
Šifrování "false" Pokud trueSQL 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``yesa no. Další informace naleznete v tématu Syntaxe připojovacího řetězce.

Počínaje rozhraním .NET Framework 4.5 musí TrustServerCertificate Encrypt název serveru (nebo IP adresa) v certifikátu ssl SQL Server přesně odpovídat názvu serveru (nebo IP adrese) zadanému v připojovací řetězec. V opačném případě se pokus o připojení nezdaří.
Zařazení "true" trueznačí, že nástroj pro sdružování připojení SQL Server automaticky začte připojení do aktuálního kontextu transakce vlákna vytvoř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í, 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 bý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, připojení k primárnímu serveru (zadanému klíčovým slovem Server) bude úspěšné, pokud je primární server k dispozici.
Počáteční katalog

-nebo-

databáze
Název databáze.

Název databáze může být 128 znaků nebo méně.
Integrované zabezpečení

-nebo-

Trusted_Connection
"false" Když falsese v připojení zadá ID uživatele a heslo. Pokud truese k ověřování používají aktuální přihlašovací údaje účtu Windows.

Rozpoznané hodnoty jsou true, , false``yes, noa sspi (důrazně doporučeno), které jsou 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í.

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 rovny 1. Hodnoty, které jsou menší než minimální velikost fondu , generují chybu.
Minimální velikost fondu 0 Minimální počet povolených připojení ve fondu.

Platné hodnoty jsou větší nebo rovny 0. Nula (0) v tomto poli znamená, že se na začátku neotevře žádná minimální připojení.

Hodnoty větší než maximální velikost fondu generují chybu.
MultipleActiveResultSets "false" Když 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 na něm bylo možné 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 FALSE Vždy určete multiSubnetFailover=True při připojování k naslouchacímu procesu skupiny dostupnosti SQL Server 2012 (nebo novější) nebo instanci clusteru s podporou převzetí služeb při selhání SQL Server 2012 (nebo novější). multiSubnetFailover=True nakonfiguruje SqlClient tak, aby poskytoval rychlejší detekci a připojení k (aktuálně) aktivnímu serveru. Možné hodnoty jsou Yes a nebo True Noa False 1 a 0. Příklad:

MultiSubnetFailover=True

Výchozí formát je False. Další informace o podpoře sqlClient pro skupiny dostupnosti AlwaysOn naleznete v tématu Podpora sqlClient pro vysokou dostupnost, 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)

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 "(místní)"), 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 8000 Velikost v bajtech síťových paketů používaných ke komunikaci s instancí SQL Server

Velikost paketů může být větší nebo rovna 512 a menší nebo rovna 32768.
Heslo

-nebo-

PWD
Heslo pro přihlášení k účtu SQL Server Nedoporučuje se. Pokud chcete zachovat vysokou úroveň zabezpečení, důrazně doporučujeme místo toho použít klíčové Integrated Security slovo nebo Trusted_Connection klíčové slovo. 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í být 128 znaků nebo méně.
Zachování bezpečnostních údajů

-nebo-

PersistSecurityInfo
"false" Pokud je nastavené nebo no (důrazně doporučeno), informace citlivé na false 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í připojovací řetězec resetuje všechny hodnoty připojovací řetězec včetně hesla. Rozpoznané hodnoty jsou true, , false``yesa no.
PoolBlockingPeriod Auto Nastaví chování blokující doby pro fond připojení. Podrobnosti PoolBlockingPeriod najdete v vlastnosti.
Sdružování "true" Pokud je hodnota tohoto klíče nastavená na hodnotu true, při zavření aplikace se do fondu přidá 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.

Připojení 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 je replikace podporována pomocí připojení.
Transakční vazba Implicitní zrušení vazby Řídí přidružení připojení k vyčtené 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 po skončení. Po odpojení se další požadavky na připojení provádějí v režimu automatického dokončování. Vlastnost System.Transactions.Transaction.Current není při provádění požadavků při aktivní transakci zaškrtnutá. Po ukončení transakce se v režimu automatickéhocommitu provádějí další požadavky.

Pokud systém ukončí transakci (v rozsahu 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řipojené k transakci, dokud se připojení nezavře nebo se zavolá explicitně SqlConnection.TransactionEnlist(null) . Počínaje rozhraním .NET Framework 4 se změny implicitního zrušení vazby zastarávají. Vyvolá InvalidOperationException se, pokud není zařazená transakce nebo není-li Transaction.Current zalistovaná transakce aktivní.
TransparentNetworkIPResolution Viz popis. Pokud je hodnota tohoto klíče nastavená na true, aplikace je nutná k načtení všech IP adres pro konkrétní položku DNS a pokus o připojení k prvnímu v seznamu. Pokud se připojení nenaváže do 0,5 sekund, 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, TransparentNetworkIPResolution bude ignorován.

Failover Partner Pokud je klíč nastavený, TransparentNetworkIPResolution bude ignorován.

Hodnota tohoto klíče musí být true, , falsenebo yes``no.

Hodnota yes je považována za hodnotu true.

Hodnota no je považována za hodnotu false.

Výchozí hodnoty jsou následující:

  • false Kdy:

    • Připojení k 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" Při nastavení truena hodnotu SSL se používá k šifrování kanálu při vynechání procházení řetězu certifikátů k ověření důvěryhodnosti. Pokud je nastavená true hodnota TrustServerCertificate a funkce Encrypt je nastavená na false, kanál není šifrovaný. Rozpoznané hodnoty jsou true, false, yesa no. Další informace najdete v tématu Syntaxe připojovacího řetězce.
Verze systému typů Řetězcová hodnota, která označuje systém typů, který aplikace očekává. Funkce dostupné klientské aplikaci závisí na verzi SQL Server a na úrovni kompatibility databáze. Explicitně nastavíte verzi systému typů, kterou klientská aplikace napsala, aby se zabránilo potenciálním problémům, které by mohly způsobit přerušení aplikace, pokud se používá jiná verze SQL Server. Poznámka: Verzi systému typů 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 modulu 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 být použit. 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 místo toho používat Integrated Security klíčová slova nebo Trusted_Connection klíčová slova. 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 128 znaků nebo méně.
Instance uživatele "false" Hodnota, která označuje, jestli se má přesměrovat připojení z výchozí instance SQL Server Express na instanci iniciovanou 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 Server

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

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

Poznámka

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

Poznámka

Soubory univerzálního datového propojení (UDL) nejsou podporované pro rozhraní .NET Framework Zprostředkovatel dat 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í informací o ID uživatele a hesle z dialogového okna a připojování 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 založené na vstupu uživatele, použijte nový SqlConnectionStringBuilder, který ověří připojovací řetězec a pomůže tento problém odstranit. Další informace najdete v tvůrcích připojovacích řetězců .

Platí pro

Viz také