Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A Microsoft.Data.SqlClient a támogatott .NET-adatszolgáltató az SQL Server, az Azure SQL Database, az Azure SQL Managed Instance, az Azure Synapse Analytics, a Microsoft Fabric SQL-adatbázisa és a Microsoft Fabric Warehouse számára. Az illesztőprogram NuGet csomagként érkezik, függetlenül a .NET futásidőtől.
Válassz egy kiadást
Használj támogatott General Availability (GA) kiadást gyártási alkalmazásokhoz. A legújabb GA kiadás a Microsoft. Data.SqlClient 7.1.1.
| Kiadási ág | Legutóbbi verzió | Támogatási szint | Válassza ezt, ha |
|---|---|---|---|
| 7.1 | 7.1.1 | Szabványos támogatási időszak (STS) | Szükséged van a legújabb illesztőprogram-funkciókra, és frissíthetsz a rendszeres kiadási ütemben. |
| 7.0 | 7.0.3 | Szabványos támogatási időszak (STS) | Szervizjavításokra van szükséged, miközben a frissítésre készülsz a támogatás 2026. december 17-i megszűnése előtt. |
| 6.1 | 6.1.7 | Hosszú távú támogatás (LTS) | Hosszabb támogatási időszakot preferálsz, és nincs szükséged a 7.x-ben bevezetett funkciókra. |
A jelenlegi javítási verziók, támogatási dátumok, célkeretrendszerek és adatbázis-kompatibilitás esetén lásd: SqlClient driver support lifecycle.
Telepítsd a magcsomagot
Futtasd a következő parancsot a projektfájlodat tartalmazó könyvtárból:
dotnet add package Microsoft.Data.SqlClient
A parancs kiválasztja a legfrissebb, a projekttel kompatibilis stabil verziót. Az ismételhető buildeléshez egy adott verzió rögzítéséhez adja meg a verziót:
dotnet add package Microsoft.Data.SqlClient --version <version>
A parancs hozzáad egy PackageReference elemet a projektfájlodhoz. A 7.1.1-es verzióban a projektfájl ezt a sort tartalmazza:
<PackageReference Include="Microsoft.Data.SqlClient" Version="7.1.1" />
Ha Microsoft.Data.SqlClient.Extensions.Azure is hozzáadod, a PackageReference-je ugyanazt a verziót használja.
A függőségek helyreállítása és a projekt építése:
dotnet restore
dotnet build
Ha a restore vagy build figyelmeztetést jelez egy ismert sebezhetőséggel rendelkező csomagról, például NU1902 vagy NU1903, kövesse a(z) Teendők ismert sebezhetőségű csomagok jelentésekor témakörben szereplő lépéseket.
Importáljuk a driver-névteret C#-ban:
using Microsoft.Data.SqlClient;
Új alkalmazásoknál ne hivatkozz a régebbi System.Data.SqlClient csomagra vagy névtérre. Egy meglévő alkalmazás frissítéséhez lásd: Migrate from System.Data.SqlClient to Microsoft. Data.SqlClient.
A Visual Studio-val történő telepítés
- A Megoldáskezelő-ben jobb kattintással a projektre, és válaszd a Manage NuGet Packages opciót.
-
A Böngészés fülön keresd meg a
Microsoft.Data.SqlClient. - Válaszd ki a Microsoft tulajdonában lévő csomagot.
- Válassz egy támogatott stabil verziót, majd válaszd az Installációt.
További információért lásd: Csomagok telepítése és kezelése a Visual Studio-ban a NuGet Csomagkezelő használatával.
Opcionális csomagok hozzáadása
Csak akkor telepíts opcionális csomagokat, ha az alkalmazásod használja a kapcsolódó funkciót.
| Package | Add hozzá, amikor |
|---|---|
Microsoft.Data.SqlClient.Extensions.Azure |
Microsoft. Data.SqlClient 7.0 vagy újabb verziók egy illesztőprogram által biztosított Microsoft Entra hitelesítési módot használ, például Active Directory Default, Active Directory Interactive, vagy Active Directory Managed Identity. |
Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider |
Az Always Encrypted az oszlopfőkulcsokat az Azure Key Vaultban tárolja. |
Microsoft Entra hitelesítéshez SqlClient 7.0 vagy újabb verziókkal futtasd el:
dotnet add package Microsoft.Data.SqlClient.Extensions.Azure --version <same-version-as-Microsoft.Data.SqlClient>
A 7.0 magcsomag már nem tartalmazza az Azure Identity függőségeit. A 7.0.2-es verziótól kezdve a fő meghajtó és kísérő csomagok igazított verziókat használnak. Hivatkozzon a(z) Microsoft.Data.SqlClient és Microsoft.Data.SqlClient.Extensions.Azure azonos verziójára. Azoknak az alkalmazásoknak, amelyek nem használják az illesztőprogram által biztosított Microsoft Entra hitelesítést, nem igényelnek Azure kiterjesztési csomagot. Az autentifikációs beállításért lásd: Microsoft Entra-hitelesítés a Microsoft.Data.SqlClienttel.
Az illesztőprogram frissítése
Frissítés előtt nézd meg ezeket az elemeket:
Olvasd el a Microsoft.Data.SqlClient újdonságai című részt, valamint a frissítés által érintett minden verzióhoz tartozó forrásoldali kiadási megjegyzéseket.
Sorold fel az alkalmazás közvetlen és tranzitív csomaghivatkozásait:
dotnet list package --include-transitiveJegyezd fel minden kísérő csomagot, amelyre az alkalmazás közvetlenül hivatkozik, például
Microsoft.Data.SqlClient.Extensions.AzurevagyMicrosoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider.
Frissítsd a csomaghivatkozást.
dotnet add package Microsoft.Data.SqlClient --version <version>A 7.0.2 és újabb verziók esetén frissítsd az összes közvetlenül hivatkozott kísérőcsomagot ugyanarra a verzióra.
Állítsd vissza, építsd és futtatd az alkalmazás tesztjeit.
Tesztkapcsolat létrehozása, hitelesítés, tanúsítvány ellenőrzése, kapcsolat poolingolása, adattípus-átalakítások, tranzakciók és újrapróbálkozási viselkedés minden támogatott adatbáziscél esetén.
A nagyobb és javításos kiadások alkalmazásmódosításokat igényelhetnek. Például a 4.0-s verzió alapértelmezés szerint engedélyezte a titkosítást, az 5.0-s verzió a bool értékét SqlConnectionEncryptOption-ről SqlConnectionStringBuilder.Encrypt-ra változtatta, a 7.0-s verzió pedig az illesztőprogram által biztosított Microsoft Entra-hitelesítést egy külön csomagba helyezte át.
A 7.0.2-es verziótól kezdve a(z) Microsoft.Data.SqlClient.Extensions.Abstractions, Microsoft.Data.SqlClient.Internal.Logging és Microsoft.Data.SqlClient.Extensions.Azure szerelvényverziói 1.0.0.0-ról 7.0.0.0-re változtak. A .NET Framework alkalmazásoknak újra kell építeniük az igazított csomagok ellen, vagy kötött átirányításokat kell hozzáadniuk. A jelenlegi .NET alkalmazásokat nem érinti ez a assembly identitásváltozás.
Értsd meg a célkereteket
A Microsoft.Data.SqlClient 7.1 az alkalmazásokat a következő platformokon támogatja:
- .NET 8 vagy újabb verziók támogatták a Windows, Linux és macOS verziókat.
- .NET Framework 4.6.2 vagy újabb verziók Windows-on.
A NuGet csomag tartalmaz egy .NET Standard 2.0 kompatibilitási eszközt is a könyvtárakhoz. Egy futtatható alkalmazásnak támogatott .NET vagy .NET Framework futóidőt kell céloznia. Egy könyvtár .NET Standard célverziója nem jelenti azt, hogy minden azt használó futtatókörnyezet támogatott.
A csomag visszaállítja a kezelt és natív függőségeit a NuGet-en keresztül. Ne másoljon egyedi illesztőprogram-szerelvényeket vagy natív SQL Network Interface (SNI) könyvtárakat az alkalmazások között.
.NET-keretrendszerprojektek
A cikkekben szereplő minták a .NET-et célozzák meg. Új fejlesztésekhez használd a .NET-et a .NET Framework helyett. További információért lásd: A .NET Framework áttekintése.
Azok a projektek, amelyek a .NET Framework-et célozzák meg, alapértelmezés szerint C# 7.3-at használnak, így a .NET-re írt minta nem fordítható le változtatás nélkül. Gyorsindítás: Csatlakozás és lekérdezés a Microsoft.Data.SqlClienttel rendelkezik egy .NET Framework füllel, amely a mintája C# 7.3-as verzióját tartalmazza.
Felkészülés az üzembe helyezésre
Ugyanarra az operációs rendszerre és architektúrára publikálj, mint a gyártásban. Keretrendszerfüggő telepítés esetén:
dotnet publish --configuration ReleaseFutásidő-specifikus telepítéshez:
dotnet publish --configuration Release --runtime <runtime-identifier>Telepítsd a teljes publikációs kimenetet. Ne csak a(z)
Microsoft.Data.SqlClient.dllelemet válassza.Győződj meg róla, hogy a célpontnak van a szükséges .NET futóideje, hacsak nem publikálsz önálló alkalmazást.
Teszteljük a közzétett kimenetet a cél operációs rendszeren és architektúrán.
Teszteld az összes gyártásban használt hitelesítési módot. Az integrált hitelesítés, Kerberos, tanúsítványok, kezelt identitás és Azure Key Vault hozzáférés a telepítési környezettől függ.
Vizsgálja át a megoldott függőségi gráfot ismert sebezhetőségek után, és frissítse a támogatott csomagsorokat, amikor javítások elérhetők.
A globalizáció-invariáns mód nem támogatott. A jelenlegi platformkövetelményekért lásd: Támogatott operációs rendszerek.
Offline csomag telepítése
Töltsd le a csomagot és annak függőségeit NuGet.org-ről, másold le őket egy belső csomagforrásba, és onnan állítsd vissza. Az ismételhető offline buildeléshez rögzítsd a csomagverziókat, és őrizd meg a teljes függőségi készletet.