SqlConnection.ConnectionString Tulajdonság

Definíció

Névtér:: System.Data.SqlClient

Szerelvény:: System.Data.SqlClient.dll

Szerelvény:: System.Data.dll

Forrás:: System.Data.SqlClient.notsupported.cs

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Lekéri vagy beállítja a SQL Server adatbázis megnyitásához használt sztringet.

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

Tulajdonság értéke

String

A forrásadatbázis nevét és a kezdeti kapcsolat létrehozásához szükséges egyéb paramétereket tartalmazó kapcsolati karakterlánc. Az alapértelmezett érték egy üres sztring.

Megvalósítás

ConnectionString

Attribútumok: DataSysDescriptionAttribute SettingsBindableAttribute

Kivételek

ArgumentException

Érvénytelen kapcsolati karakterlánc argumentum lett megadva, vagy nincs megadva egy kötelező kapcsolati karakterlánc argumentum.

Példák

Az alábbi példa létrehozza SqlConnection és beállítja a tulajdonságot a ConnectionString kapcsolat megnyitása előtt.

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

Megjegyzések

A ConnectionString hasonló az OLE DB kapcsolati karakterlánc, de nem azonos. Az OLE DB-vel vagy az ADO-vel ellentétben a visszaadott kapcsolati karakterlánc ugyanaz, mint a felhasználó által megadott ConnectionString, a biztonsági adatok nélkül, ha a Biztonsági adatok megőrzése érték false (alapértelmezett) értékre van állítva. A SQL Server .NET-keretrendszer Data Provider nem megőrzi vagy nem adja vissza a jelszót egy kapcsolati karakterlánc, kivéve, ha a biztonsági adatok megőrzése beállítást true értékre állítja.

A ConnectionString tulajdonság használatával csatlakozhat egy adatbázishoz. Az alábbi példa egy tipikus kapcsolati karakterlánc szemléltet.

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

Az új SqlConnectionStringBuilder használatával futtatáskor érvényes kapcsolati sztringeket hozhat létre. További információ: Kapcsolati karakterlánc építők.

A ConnectionString tulajdonság csak akkor állítható be, ha a kapcsolat lezárult. A kapcsolati karakterlánc értékek közül sok rendelkezik írásvédett tulajdonságokkal. Ha a kapcsolati karakterlánc be van állítva, ezek a tulajdonságok frissülnek, kivéve, ha hiba észlelhető. Ebben az esetben egyik tulajdonság sem frissül. SqlConnection tulajdonságok csak azokat a beállításokat adja vissza, amelyek a ConnectionString.

Helyi számítógéphez való csatlakozáshoz adja meg a kiszolgálóhoz tartozó "(helyi)" értéket. Ha nincs megadva kiszolgálónév, a rendszer megpróbál kapcsolatot létesíteni a helyi számítógép alapértelmezett példányával.

A ConnectionString zárt kapcsolaton való alaphelyzetbe állítása alaphelyzetbe állítja az összes kapcsolati karakterlánc értéket (és a kapcsolódó tulajdonságokat), beleértve a jelszót is. Ha például egy olyan kapcsolati karakterlánc állít be, amely tartalmazza a "Database= AdventureWorks" értéket, majd állítsa vissza a kapcsolati karakterlánc "Data Source=myserver; Az Integrated Security=true", a Database tulajdonság már nem az "AdventureWorks" értékre van állítva.

A kapcsolati karakterlánc a beállítás után azonnal elemezni kell. Ha a szintaxis hibáit észleli az elemzés során, a rendszer futásidejű kivételt hoz létre, például ArgumentException: Más hibák csak akkor találhatók, ha megkísérlik megnyitni a kapcsolatot.

A kapcsolati karakterlánc alapformátuma kulcsszó-érték párok sorozatát tartalmazza pontosvesszővel elválasztva. Az egyenlőségjel (=) összekapcsolja az egyes kulcsszavakat és azok értékét. Pontosvesszőt, egy idézőjelet vagy dupla idézőjelet tartalmazó értékek hozzáadásához az értéket idézőjelek közé kell foglalni. Ha az érték pontosvesszőt és kettős idézőjelet is tartalmaz, az érték egyetlen idézőjelben is csatolható. Az egyetlen idézőjel akkor is hasznos, ha az érték kettős idézőjellel kezdődik. Ezzel szemben a kettős idézőjel akkor használható, ha az érték egyetlen idézőjellel kezdődik. Ha az érték egy- és két idézőjelet is tartalmaz, az érték beágyazásához használt idézőjel karaktert minden alkalommal meg kell duplázni, amikor az az értéken belül történik.

Ha a sztringértékbe előző vagy záró szóközöket szeretne belefoglalni, az értéket idézőjelek vagy kettős idézőjelek közé kell foglalni. A rendszer figyelmen kívül hagyja az egész szám, logikai vagy enumerált értékek körüli kezdő vagy záró szóközöket, még akkor is, ha idézőjelek közé van állítva. A sztringkonstans kulcsszón vagy értéken belüli szóközök azonban megmaradnak. Az egy- vagy kettős idézőjelek elválasztójelek (például adatforrás= my'Server vagy Data Source= my"Server) használata nélkül is használhatók egy kapcsolati karakterlánc, kivéve, ha az idézőjel az érték első vagy utolsó karaktere.

A kulcsszavak nem megkülönböztetik a kis- és nagybetűket.

Az alábbi táblázat a kulcsszóértékek érvényes nevét sorolja fel a ConnectionStringkövetkező táblázatban:

Keyword	Alapértelmezett	Leírás
`Addr`	N/A	Az adatforrás szinonimája.
`Address`	N/A	Az adatforrás szinonimája.
`App`	N/A	Az alkalmazásnév szinonimája.
`Application Name`	N/A	Az alkalmazás neve vagy ".NET SQLClient Data Provider", ha nincs megadva alkalmazásnév. Az alkalmazásnév legfeljebb 128 karakter hosszúságú lehet.
`ApplicationIntent`	`ReadWrite`	Deklarálja az alkalmazás számítási feladatainak típusát a kiszolgálóhoz való csatlakozáskor. A lehetséges értékek a következők: `ReadOnly` és `ReadWrite`. Például: `ApplicationIntent=ReadOnly` Az Always On rendelkezésre állási csoportok SqlClient-támogatásáról további információt a SqlClient magas rendelkezésre állású és vészhelyreállításicímű témakörben talál.
`Asynchronous Processing` -vagy- `Async`	'false'	Amikor `true`engedélyezi az aszinkron műveletek támogatását. A felismert értékek a következők`true`: , `falseyes`és `no`. Ez a tulajdonság .NET Framework 4.5-től kezdve figyelmen kívül lesz hagyva. Az aszinkron programozás SqlClient-támogatásáról további információt az Aszinkron programozás című témakörben talál.
`AttachDBFilename` -vagy- `Extended Properties` -vagy- `Initial File Name`	N/A	Az elsődleges adatbázisfájl neve, beleértve egy csatolható adatbázis teljes elérési útját. Az AttachDBFilename csak .mdf kiterjesztésű elsődleges adatfájlok esetében támogatott. Ha az AttachDBFileName kulcs értéke meg van adva a kapcsolati karakterlánc, az adatbázis csatolva lesz, és a kapcsolat alapértelmezett adatbázisává válik. Ha ez a kulcs nincs megadva, és az adatbázist korábban csatolták, az adatbázis nem lesz újra csatolva. A korábban csatolt adatbázis lesz a kapcsolat alapértelmezett adatbázisa. Ha ez a kulcs az AttachDBFileName kulccsal együtt van megadva, a rendszer ennek a kulcsnak az értékét használja aliasként. Ha azonban a nevet már használják egy másik csatolt adatbázisban, a kapcsolat sikertelen lesz. Az elérési út lehet abszolút vagy relatív a DataDirectory helyettesítési sztring használatával. DataDirectory használata esetén az adatbázisfájlnak a helyettesítési sztring által hivatkozott könyvtár alkönyvtárában kell lennie. Megjegyzés: A távoli kiszolgáló, a HTTP és az UNC elérési út neve nem támogatott. Az adatbázis nevét az "adatbázis" kulcsszóval (vagy annak egyik aliasával) kell megadni az alábbiak szerint: `"AttachDbFileName=\|DataDirectory\|\data\YourDB.mdf;integrated security=true;database=YourDatabase"` Hiba jön létre, ha egy naplófájl ugyanabban a könyvtárban található, mint az adatfájl, és az "adatbázis" kulcsszót használja az elsődleges adatfájl csatolásakor. Ebben az esetben távolítsa el a naplófájlt. Az adatbázis csatolása után a rendszer automatikusan létrehoz egy új naplófájlt a fizikai elérési út alapján.
`Authentication`	N/A	A Csatlakozás az SQL Database-hez Azure Active Directory hitelesítéssel. Az érvényes értékek a következők: Active Directory integrált, Active Directory jelszó, SQL-jelszó.
`Column Encryption Setting`	N/A	Engedélyezi vagy letiltja az Always Encrypted funkciót a kapcsolathoz.
`Connect Timeout` -vagy- `Connection Timeout` -vagy- `Timeout`	15	A kiszolgálóval való kapcsolat várakozási ideje (másodpercben), mielőtt megszakítja a kísérletet, és hibát okozna. Az érvényes értékek 0-nál nagyobbak vagy egyenlők, és kisebbek, mint 2147483647. Amikor Azure SQL Database nyit meg kapcsolatot, állítsa a kapcsolat időtúllépését 30 másodpercre.
`Connection Lifetime` -vagy- `Load Balance Timeout`	0	Amikor egy kapcsolat visszakerül a készletbe, annak létrehozási idejét összehasonlítjuk az aktuális időponttal, és a kapcsolat megszűnik, ha ez az időtartam (másodpercben) meghaladja a megadott `Connection Lifetime` értéket. Ez a fürtözött konfigurációkban hasznos a terheléselosztás kényszerítésére egy futó kiszolgáló és egy nemrég online állapotba hozott kiszolgáló között. A nulla (0) érték miatt a készletezett kapcsolatok maximális kapcsolati időtúllépést eredményeznek.
`ConnectRetryCount`	1	Szabályozza az újracsatlakozási kísérletek számát, miután az ügyfél azonosít egy tétlen kapcsolati hibát. Az érvényes értékek 0 és 255 között vannak. Az alapértelmezett érték 1. A 0 azt jelenti, hogy ne próbálja meg újracsatlakozni (tiltsa le a kapcsolat rugalmasságát). További információ a kapcsolat rugalmasságáról: .NET SqlConnection-paraméterek a kapcsolat újrapróbálkozáshoz és Műszaki cikk – Tétlen kapcsolat rugalmassága.
`ConnectRetryInterval`	10	Megadja az egyes újrapróbálkozási kísérletek (ConnectRetryCount) közötti időt. Az érvényes értékek 1–60 másodperc (default=10), amelyeket az első újracsatlakozási kísérlet után alkalmazunk. Megszakadt kapcsolat észlelésekor az ügyfél azonnal megkísérli az újracsatlakozást; ez az első újracsatlakozási kísérlet, és csak akkor fordul elő, ha a ConnectRetryCount értéke 0-nál nagyobb. Ha az első újracsatlakozási kísérlet meghiúsul, és a ConnectRetryCount nagyobb, mint 1, az ügyfél megvárja a ConnectRetryIntervalt, hogy megpróbálja a második és az azt követő újracsatlakozási kísérleteket. További információ a kapcsolat rugalmasságáról: .NET SqlConnection-paraméterek a kapcsolat újrapróbálkozáshoz és Műszaki cikk – Tétlen kapcsolat rugalmassága.
`Context Connection`	'false'	`true`, ha folyamatban lévő kapcsolatot kell létesíteni SQL Server.
`Current Language` -vagy- `Language`	N/A	Beállítja az adatbázis-kiszolgáló figyelmeztetéséhez vagy hibaüzeneteihez használt nyelvet. A nyelv neve legfeljebb 128 karakter hosszúságú lehet.
`Data Source` -vagy- `Server` -vagy- `Address` -vagy- `Addr` -vagy- `Network Address`	N/A	Annak a SQL Server-példánynak a neve vagy hálózati címe, amelyhez csatlakozni szeretne. A portszám a kiszolgáló neve után adható meg: `server=tcp:servername, portnumber` Helyi példány megadásakor mindig használja a (helyi) értéket. Protokoll kényszerítéséhez adja hozzá az alábbi előtagok egyikét: `np:(local), tcp:(local), lpc:(local)` A .NET Framework 4.5-től kezdve az alábbiak szerint is csatlakozhat LocalDB-adatbázishoz: `server=(localdb)\\myInstance` További információ a LocalDB-ről: SqlClient Support for LocalDB. Az adatforrásnak a TCP vagy a Named Pipes formátumot kell használnia. A TCP formátuma a következő: - tcp:<host name>\<instance name> - tcp:<gazdagép neve,TCP></IP-port száma> A TCP-formátumnak a "tcp:" előtaggal kell kezdődnie, amelyet az adatbázispéldány követ egy gazdagépnév és egy példánynév által megadott módon. Ez a formátum nem alkalmazható Azure SQL Database való csatlakozáskor. A TCP automatikusan ki van választva a Azure SQL Database való kapcsolatokhoz, ha nincs megadva protokoll. A gazdagép nevét az alábbi módok egyikével kell megadni: - NetBIOSName - IPv4Address - IPv6Address A példánynév egy adott TCP/IP-portszám feloldására szolgál, amelyen egy adatbázispéldány található. Másik lehetőségként a TCP/IP-port számának közvetlen megadása is engedélyezett. Ha sem a példány neve, sem a portszáma nincs megadva, a rendszer az alapértelmezett adatbázispéldányt használja. A nevesített csövek formátuma a következő: - np:\\<host name>\pipe\<pipe name> A Nevesített csövek formátumnak az "np:" előtaggal kell kezdődnie, amelyet egy elnevezett csőnév követ. A gazdagép nevét az alábbi módok egyikével kell megadni: - NetBIOSName - IPv4Address - IPv6Address A csőnév annak az adatbázispéldánynak a azonosítására szolgál, amelyhez a .NET-keretrendszeralkalmazás csatlakozik. Ha a hálózati kulcs értéke meg van adva, a "tcp:" és az "np:" előtagokat nem szabad megadni. Note: A MEGOSZTOTT memória helyett a TCP használatát kényszerítheti a tcp: előtaggal a kapcsolati karakterlánc kiszolgálónevére, vagy a localhost használatával.
`Encrypt`	'false'	Ha `true`, SQL Server SSL-titkosítást használ az ügyfél és a kiszolgáló között küldött összes adathoz, ha a kiszolgáló rendelkezik tanúsítvánnyal. A felismert értékek a következők`true`: , `falseyes`és `no`. További információ: Kapcsolati sztring szintaxisa. A .NET Framework 4.5-ös verziójától kezdve, ha `TrustServerCertificate` hamis, és `Encrypt` igaz, a SQL Server SSL-tanúsítvány kiszolgálónevének (vagy IP-címének) pontosan meg kell egyeznie a kapcsolati karakterlánc megadott kiszolgálónévvel (vagy IP-címmel). Ellenkező esetben a kapcsolati kísérlet sikertelen lesz.
`Enlist`	'true'	`true` azt jelzi, hogy a SQL Server kapcsolatkészletező automatikusan bevonja a kapcsolatot a létrehozási szál aktuális tranzakciós környezetében.
`Failover Partner`	N/A	Annak a feladatátvevő partnerkiszolgálónak a neve, ahol az adatbázis-tükrözés konfigurálva van. Ha a kulcs értéke "", akkor a kezdeti katalógusnak jelen kell lennie, és az értéke nem lehet "". A kiszolgáló neve legfeljebb 128 karakter hosszúságú lehet. Ha feladatátvevő partnert ad meg, de a feladatátvevő partnerkiszolgáló nincs konfigurálva adatbázis-tükrözéshez, és az elsődleges kiszolgáló (a kiszolgáló kulcsszóval megadva) nem érhető el, akkor a kapcsolat sikertelen lesz. Ha feladatátvevő partnert ad meg, és az elsődleges kiszolgáló nincs konfigurálva az adatbázis-tükrözéshez, az elsődleges kiszolgálóhoz (a Kiszolgáló kulcsszóval megadva) való kapcsolat sikeres lesz, ha az elsődleges kiszolgáló elérhető.
`Initial Catalog` -vagy- `Database`	N/A	Az adatbázis neve. Az adatbázis neve legfeljebb 128 karakter hosszúságú lehet.
`Integrated Security` -vagy- `Trusted_Connection`	'false'	Amikor `false`a felhasználóazonosító és a jelszó meg van adva a kapcsolatban. Ha `true`, a rendszer az aktuális Windows fiók hitelesítő adatait használja a hitelesítéshez. A felismert értékek a , , `true`, és `false` (erősen ajánlottak), amelyek egyenértékűek az értékekkel`yes`. `nosspitrue` Ha a felhasználóazonosító és a jelszó meg van adva, és az integrált biztonság értéke igaz, a rendszer figyelmen kívül hagyja a felhasználói azonosítót és a jelszót, és az integrált biztonságot használja. A SqlCredential biztonságosabb módszer a SQL Server-hitelesítést (`Integrated Security=false`) használó kapcsolatok hitelesítő adatainak megadására.
`Max Pool Size`	100	A készletben engedélyezett kapcsolatok maximális száma. Az érvényes értékek 1-nél nagyobbak vagy egyenlők. A minimális készletméretnél kisebb értékek hibát okoznak.
`Min Pool Size`	0	A készletben engedélyezett kapcsolatok minimális száma. Az érvényes értékek 0-nál nagyobbak vagy egyenlők. Ebben a mezőben a nulla (0) azt jelenti, hogy a rendszer kezdetben nem nyit meg minimális kapcsolatokat. A maximális készletméretnél nagyobb értékek hibát okoznak.
`MultipleActiveResultSets`	'false'	Amikor `true`egy alkalmazás több aktív eredményhalmazt (MARS) is képes fenntartani. Amikor `false`egy alkalmazásnak feldolgoznia vagy megszakítania kell az összes eredményhalmazt egy kötegből, mielőtt bármilyen más köteget végrehajthat az adott kapcsolaton. A felismert értékek a `true` és a `false` vannak. További információért lásd a(z) Több aktív eredményhalmaz (MARS).
`MultiSubnetFailover`	FALSE	Mindig adja meg a `multiSubnetFailover=True`, amikor egy SQL Server 2012(vagy újabb) rendelkezésre állási csoport vagy egy SQL Server 2012-SQL Server (vagy újabb) feladatátvevő fürtpéldány rendelkezésre állási csoportfigyelőjével csatlakozik. `multiSubnetFailover=True` Konfigurálja az SqlClientet, hogy gyorsabb észlelést és kapcsolatot biztosítson az (jelenleg) aktív kiszolgálóhoz. A lehetséges értékek a következők: `YesNo` és `TrueFalse1`.`0` Például: `MultiSubnetFailover=True` Az alapértelmezett érték a `False`. Az SqlClient Always On AG-hez nyújtott támogatásával kapcsolatos további információkért tekintse meg az SqlClient magas rendelkezésre állású és vészhelyreállítási támogatását ismertető témakört.
`Network Library` -vagy- `Network` -vagy- `Net`	N/A	A SQL Server egy példányával létesített kapcsolat létrehozásához használt hálózati kódtár. A támogatott értékek a következők: dbnmpntw (nevesített csövek) dbmsrpcn (Multiprotocol, Windows RPC) dbmsadsn (Apple Talk) dbmsgnet (VIA) dbmslpcn (megosztott memória) dbmsspxn (IPX/SPX) dbmssocn (TCP/IP) Dbmsvinn (Banyan Vines) A megfelelő hálózati DLL-t telepíteni kell arra a rendszerre, amelyhez csatlakozik. Ha nem ad meg hálózatot, és helyi kiszolgálót használ (például "." vagy "(helyi)"), a rendszer megosztott memóriát használ. Ebben a példában a hálózati kódtár Win32 Winsock TCP/IP (dbmssocn), a használt port pedig az 1433. `Network Library=dbmssocn;Data Source=000.000.000.000,1433;`
`Packet Size`	8 000	A SQL Server egy példányával való kommunikációhoz használt hálózati csomagok bájtban megadott mérete. A csomag mérete 512-nél nagyobb vagy egyenlő lehet, és 32768-nál kisebb vagy egyenlő lehet.
`Password` -vagy- `PWD`	N/A	A SQL Server fiók bejelentkezésének jelszava. Nem ajánlott. A magas szintű biztonság fenntartása érdekében javasoljuk, hogy inkább a kulcsszót vagy `Integrated Security` a kulcsszót `Trusted_Connection` használja. A SqlCredential biztonságosabb módszer a SQL Server hitelesítést használó kapcsolatok hitelesítő adatainak megadására. A jelszónak legalább 128 karakter hosszúságúnak kell lennie.
`Persist Security Info` -vagy- `PersistSecurityInfo`	'false'	Ha be van állítva `false` vagy `no` (erősen ajánlott), a rendszer nem adja vissza a kapcsolat részeként a biztonsági szempontból érzékeny információkat, például a jelszót, ha a kapcsolat nyitva van, vagy valaha is nyitott állapotban volt. A kapcsolati karakterlánc alaphelyzetbe állítása alaphelyzetbe állítja az összes kapcsolati karakterlánc értéket, beleértve a jelszót is. A felismert értékek a következők`true`: , `falseyes`és `no`.
`PoolBlockingPeriod`	Auto	Beállítja a kapcsolatkészlet blokkolási időszakának viselkedését. Részletekért tekintse meg PoolBlockingPeriod a tulajdonságot.
`Pooling`	'true'	Ha a kulcs értéke igaz értékre van állítva, az újonnan létrehozott kapcsolatok hozzáadva lesznek a készlethez, amikor az alkalmazás bezárja. Ugyanazon kapcsolat következő megnyitásakor a rendszer ezt a kapcsolatot a készletből fogja kirajzolni. A kapcsolatok akkor tekinthetők azonosnak, ha ugyanazzal a kapcsolati karakterlánc rendelkeznek. A különböző kapcsolatok különböző kapcsolati sztringekkel rendelkeznek. Ennek a kulcsnak az értéke lehet "igaz", "hamis", "igen", vagy "nem".
`Replication`	'false'	`true` ha a replikáció támogatott a kapcsolat használatával.
`Transaction Binding`	Implicit kötés feloldása	Szabályozza a kapcsolat társítását egy bevont `System.Transactions` tranzakcióval. A lehetséges értékek a következők: `Transaction Binding=Implicit Unbind;` `Transaction Binding=Explicit Unbind;` Az implicit kötetlen kapcsolat miatt a kapcsolat megszakad a tranzakciótól, amikor véget ér. A leválasztást követően további kérések lesznek végrehajtva a kapcsolaton automatikusan küldött módban. A `System.Transactions.Transaction.Current` rendszer nem ellenőrzi a tulajdonságot a kérelmek végrehajtásakor, amíg a tranzakció aktív. A tranzakció befejeződése után a rendszer további kéréseket hajt végre automatikus feladatátvételi módban. Ha a rendszer az utolsó parancs befejeződése előtt befejezi a tranzakciót (egy használatblokk hatókörében), a rendszer a következőt fogja dobni InvalidOperationException: . Az explicit kapcsolat feloldása miatt a kapcsolat a tranzakcióhoz csatolva marad, amíg a kapcsolat le nem zárul, vagy explicit `SqlConnection.TransactionEnlist(null)` nem lesz meghívva. .NET Framework 4-től kezdődően az implicit kötés módosítása elavulttá teszi az explicit kötést. A `InvalidOperationException` művelet akkor lesz eldobva, ha `Transaction.Current` nem a bevont tranzakció, vagy ha a bevont tranzakció nem aktív.
`TransparentNetworkIPResolution`	Lásd a leírást.	Ha ennek a kulcsnak az értéke be van állítva `true`, az alkalmazásnak le kell kérnie egy adott DNS-bejegyzéshez tartozó összes IP-címet, és meg kell kísérelnie a kapcsolatot a listában szereplő elsővel. Ha a kapcsolat 0,5 másodpercen belül nem jön létre, az alkalmazás megpróbálja párhuzamosan csatlakozni az összes többi felhasználóhoz. Az első válaszok után az alkalmazás létrehozza a kapcsolatot a válaszadó IP-címével. Ha a `MultiSubnetFailover` kulcs be van állítva `true`, `TransparentNetworkIPResolution` a rendszer figyelmen kívül hagyja. Ha a `Failover Partner` kulcs be van állítva, `TransparentNetworkIPResolution` a rendszer figyelmen kívül hagyja. A kulcs értékének a következőnek kell lennie`true`: , `falseyes`vagy `no`. Egy érték `yes` ugyanúgy lesz kezelve, mint a .`true` Egy érték `no` ugyanúgy lesz kezelve, mint a .`false` Az alapértelmezett értékek a következők: `false` mikor: Csatlakozás Azure SQL Database, ahol az adatforrás a következőkkel végződik: .database.chinacloudapi.cn .database.usgovcloudapi.net .database.cloudapi.de .database.windows.net `Authentication` "Active Directory Jelszó" vagy "Active Directory Integrált" `true` minden más esetben.
`TrustServerCertificate`	'false'	Ha be van `true`állítva, az SSL használatával titkosítja a csatornát, amikor megkerüli a tanúsítványláncot a megbízhatóság ellenőrzéséhez. Ha a TrustServerCertificate értékre van állítva `true` , és a Titkosítás értékre van állítva `false`, a csatorna nincs titkosítva. A felismert értékek a következők`true`: , `falseyes`és `no`. További információ: Kapcsolati sztring szintaxisa.
`Type System Version`	N/A	Sztringérték, amely azt a típusrendszert jelzi, amelyet az alkalmazás elvár. Az ügyfélalkalmazások számára elérhető funkciók a SQL Server verziójától és az adatbázis kompatibilitási szintjétől függnek. Az ügyfélalkalmazás által írt típusrendszer-verzió explicit beállítása elkerüli azokat a problémákat, amelyek miatt az alkalmazás megszakadhat, ha a SQL Server egy másik verzióját használják. Note: A típusrendszer verziója nem állítható be a SQL Server folyamatban futó közös nyelvi futtatókörnyezeti (CLR) kódhoz. További információ: SQL Server Common Language Runtime Integration. A lehetséges értékek a következők: `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;` megadja, hogy az alkalmazásnak a Microsoft.SqlServer.Types.dll11.0.0.0-s verziójára lesz szüksége. A többi `Type System Version` beállításhoz a Microsoft.SqlServer.Types.dll10.0.0.0-s verziója szükséges. `Latest` elavult, és nem használható. `Latest`egyenértékű a .-nak.`Type System Version=SQL Server 2008;`
`User ID` -vagy- `UID` -vagy- `User`	N/A	A SQL Server bejelentkezési fiók. Nem ajánlott. A magas szintű biztonság fenntartása érdekében javasoljuk, hogy inkább a kulcsszavakat vagy `Integrated Security` a `Trusted_Connection` kulcsszavakat használja. A SqlCredential biztonságosabb módszer a SQL Server hitelesítést használó kapcsolatok hitelesítő adatainak megadására. A felhasználói azonosítónak legalább 128 karakter hosszúságúnak kell lennie.
`User Instance`	'false'	Egy érték, amely azt jelzi, hogy a kapcsolatot az alapértelmezett SQL Server Express-példányról átirányítja-e egy futtatókörnyezet által kezdeményezett példányra, amely a hívó fiókja alatt fut.
`Workstation ID` -vagy- `WSID`	A helyi számítógép neve	A SQL Server csatlakozó munkaállomás neve. Az azonosító legfeljebb 128 karakter hosszúságú lehet.

Az alábbi lista a kapcsolatkészletezési értékek érvényes nevét tartalmazza a ConnectionString. További információ: SQL Server-kapcsolatkészletezés (ADO.NET).

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

Ha olyan kulcsszó- vagy kapcsolatkészletezési értékeket állít be, amelyek logikai értéket igényelnek, yes használhatja truehelyette és no helyett false. Az egész számértékek sztringekként jelennek meg.

Note

A .NET keretrendszer Data Provider SQL Server saját protokollal kommunikál a SQL Server. Ezért nem támogatja az ODBC-adatforrásnév (DSN) használatát a SQL Server való csatlakozáskor, mert nem ad hozzá ODBC-réteget.

Note

Az univerzális adatkapcsolatú (UDL-) fájlok nem támogatottak a .NET Keretrendszer Data Provider SQL Server.

Figyelmeztetés

Ügyeljen arra, hogy felhasználói bemenet alapján hozzon létre kapcsolati karakterlánc (például amikor beolvassa a felhasználói azonosítót és a jelszót egy párbeszédpanelről, és hozzáfűzi az kapcsolati karakterlánc). Győződjön meg arról, hogy a felhasználó nem ágyazhat be további kapcsolati karakterlánc paramétereket ezekben az értékekben (például adjon meg egy jelszót "validpassword; database=somedb" egy másik adatbázishoz való csatolási kísérlet során). Ha felhasználói bemenet alapján kell kapcsolati sztringeket létrehoznia, használja a SqlConnectionStringBuilder, amely ellenőrzi a kapcsolati karakterlánc, és segít a probléma megoldásában. További információ: Kapcsolati karakterlánc építők.

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?