Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Microsoft. Data.SqlClient je podporovaný poskytovatel .NET dat pro SQL Server, Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, SQL database v Microsoft Fabric a Warehouse v Microsoft Fabric. Ovladač je dodáván jako balíčky NuGet nezávisle na modulu runtime .NET.
Vyberte vydání
Používejte podporovanou verzi General Availability (GA) pro produkční aplikace.
| Řada vydání | Úroveň podpory | Zvolte ho, když |
|---|---|---|
| 7.0 | Standardní dlouhodobá podpora (STS) | Potřebujete aktuální funkce ovladačů a můžete je aktualizovat podle pravidelného vydání. |
| 6.1 | Dlouhodobá podpora (LTS) | Preferujete delší dobu podpory a nepotřebujete funkce zavedené v 7.0. |
Pro aktuální verze záplat, data podpory, cílové rámce a kompatibilitu databází viz životní cyklus podpory ovladačů SqlClient.
Nainstalujte základní balíček
Spustěte následující příkaz z adresáře, který obsahuje váš projektový soubor:
dotnet add package Microsoft.Data.SqlClient
Příkaz vybírá nejnovější stabilní verzi kompatibilní s projektem. Pro připnutí verze pro opakovatelné sestavení uveďte verzi:
dotnet add package Microsoft.Data.SqlClient --version <version>
Obnovte závislosti a vybudujte projekt:
dotnet restore
dotnet build
Importujte jmenný prostor ovladačů v C#:
using Microsoft.Data.SqlClient;
U nových aplikací neodkazujte na starší System.Data.SqlClient balíček nebo jmenný prostor. Pro aktualizaci existující aplikace viz Migrace ze System.Data.SqlClient na Microsoft. Data.SqlClient.
Instalace pomocí sady Visual Studio
- V Průzkumník řešení klikněte pravým tlačítkem na projekt a vyberte Spravovat balíčky NuGet.
- Na záložce Procházet vyhledejte
Microsoft.Data.SqlClient. - Vyberte balíček vlastněný Microsoftem.
- Vyberte podporovanou stabilní verzi a poté zvolte Instalovat.
Pro více informací viz Instalace a správa balíčků ve Visual Studio.
Přidejte volitelné balíčky
Instalujte volitelné balíčky pouze tehdy, když vaše aplikace používá příslušnou funkci.
| Package | Přidejte to, až |
|---|---|
Microsoft.Data.SqlClient.Extensions.Azure |
Microsoft. Data.SqlClient 7.0 nebo novější používá autentizační režim Microsoft Entra poskytovaný ovladačem, například služba Active Directory Default, služba Active Directory Interactive, nebo služba Active Directory Managed Identity. |
Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider |
Always Encrypted ukládá hlavní klíče sloupců v Azure Key Vault. |
Pro ověřování Microsoft Entra pomocí SqlClientu 7.0 nebo novějšího spusťte:
dotnet add package Microsoft.Data.SqlClient.Extensions.Azure --version <same-version-as-Microsoft.Data.SqlClient>
Základní balíček 7.0 již neobsahuje závislosti Azure Identity. Od verze 7.0.2 používají základní ovladače a doprovodné balíčky zarovnané verze. Odkazujeme na stejnou verzi Microsoft.Data.SqlClient a Microsoft.Data.SqlClient.Extensions.Azure. Aplikace, které nepoužívají ovladačem poskytované Microsoft Entra autentizaci, nepotřebují balíček rozšíření Azure. Pro nastavení autentizace viz Microsoft Entra authentication.
Aktualizace ovladače
Před aktualizací:
Přečtěte si What's new in Microsoft.Data.SqlClient a upstreamové poznámky k verzi pro každou verzi, přes kterou aktualizace přechází.
Zkontrolujte přímé a tranzitivní odkazy na balíčky aplikace.
dotnet list package --include-transitiveAktualizujte odkaz na balíček.
dotnet add package Microsoft.Data.SqlClient --version <version>Obnovte, sestavte a spusťte testy aplikace.
Otestujte navázání připojení, autentizaci, ověřování certifikátů, sdružování připojení, převody datových typů, transakce a chování při opakování pokusů pro každý podporovaný cílový databázový systém.
Hlavní a patch verze mohou vyžadovat změny aplikací. Například verze 4.0 ve výchozím nastavení umožňovala šifrování, verze 5.0 změnila SqlConnectionStringBuilder.Encrypt z bool na SqlConnectionEncryptOption, a verze 7.0 přesunula ovladačem poskytovanou autentizaci Microsoft Entra do samostatného balíčku.
Počínaje verzí 7.0.2 se verze sestavení položek Microsoft.Data.SqlClient.Extensions.Azure, Microsoft.Data.SqlClient.Extensions.Abstractions a Microsoft.Data.SqlClient.Internal.Logging změnily z 1.0.0.0 na 7.0.0.0. Aplikace rozhraní .NET Framework je nutné znovu sestavit s použitím sjednocených balíčků nebo přidat přesměrování vazeb. Aplikace na současném .NET nejsou touto změnou identity assembleru ovlivněny.
Pochopte cílové rámce
Microsoft. Data.SqlClient 7.0 podporuje aplikace na:
- .NET Framework 4.6.2 nebo novější na Windows.
- .NET 8 nebo novější v podporovaných verzích systému Windows, Linuxu a macOS.
Balíček NuGet také obsahuje kompatibilní asset pro knihovny pro .NET Standard 2.0. Spustitelná aplikace musí cílit na podporované runtime .NET nebo .NET Framework. To, že knihovna cílí na .NET Standard, neznamená, že jsou podporována všechna runtime, která ji využívají.
Balíček obnovuje spravované a nativní závislosti prostřednictvím NuGetu. Nekopírujte jednotlivé soubory ovladačů ani nativní knihovny SQL Network Interface (SNI) mezi aplikacemi.
Příprava nasazení
Publikujte pro stejný operační systém a architekturu, která se používá v produkci. Pro nasazení závislé na frameworku:
dotnet publish --configuration ReleasePro nasazení specifické pro běhové prostředí:
dotnet publish --configuration Release --runtime <runtime-identifier>Nasaďte kompletní publikovaný výstup. Nevybírejte pouze
Microsoft.Data.SqlClient.dll.Ověřte, že cílová jednotka má požadovaný .NET runtime, pokud nepublikujete samostatnou aplikaci.
Otestujte publikovaný výstup na cílovém operačním systému a architektuře.
Otestujte každý autentizační režim používaný v produkci. Integrovaná autentizace, Kerberos, certifikáty, spravovaná identita a přístup k Azure Key Vault závisí na prostředí nasazení.
Prohledejte vyřešení grafu závislostí na známé zranitelnosti a aktualizujte podporované balíčky, jakmile budou k dispozici opravy.
Režim invariantní vůči globalizaci není podporován. Pro aktuální kvalifikace platforem viz Podporované operační systémy.
Instalace offline balíčků
Stáhněte si balíček a jeho závislosti z NuGet.org, zkopírujte je do interního zdroje balíčku a obnovte ho z tohoto zdroje. Pro opakovatelné offline buildy fixujte verze balíčků a zachovejte kompletní sadu závislostí.