Installera, uppdatera och distribuera Microsoft. Data.SqlClient

Microsoft. Data.SqlClient är den stödda .NET-dataleverantören för SQL Server, Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, SQL Database in Microsoft Fabric och Warehouse i Microsoft Fabric. Drivrutinen levereras som NuGet-paket oberoende av .NET-runtime.

Välj en frigivning

Använd en stödd General Availability (GA)-version för produktionsapplikationer.

För aktuella patchversioner, supportdatum, målramverk och databaskompatibilitet, se SqlClient-drivrutinsstödets livscykel.

Installera kärnpaketet

Kör följande kommando från katalogen som innehåller din projektfil:

dotnet add package Microsoft.Data.SqlClient

Kommandot väljer den senaste stabila versionen som är kompatibel med projektet. För att fästa en version för upprepbara byggen, specificera versionen:

dotnet add package Microsoft.Data.SqlClient --version <version>

Återställ beroenden och bygg projektet:

dotnet restore
dotnet build

Importera drivrutinsnamnrymden i C#:

using Microsoft.Data.SqlClient;

För nya applikationer, referera inte till det äldre System.Data.SqlClient paketet eller namnrymden. För att uppdatera en befintlig applikation, se Migrera från System.Data.SqlClient till Microsoft. Data.SqlClient.

Installera med Visual Studio

1. I Prieskumník riešení, högerklicka på projektet och välj Hantera NuGet-paket.
2. På fliken Bläddra sök efter Microsoft.Data.SqlClient.
3. Välj paketet som ägs av Microsoft.
4. Välj en stabil version som stöds och välj sedan Installera.

För mer information, se Installera och hantera paket i Visual Studio.

Lägg till valfria paket

Installera valfria paket endast när din applikation använder den relaterade funktionen.

För Microsoft Entra-autentisering med SqlClient 7.0 eller senare, kör:

dotnet add package Microsoft.Data.SqlClient.Extensions.Azure --version <same-version-as-Microsoft.Data.SqlClient>

Kärnpaketet 7.0 inkluderar inte längre Azure Identity-beroenden. Från och med version 7.0.2 använder kärndrivrutinen och de tillhörande paketen samordnade versionsnummer. Referera till samma version av Microsoft.Data.SqlClient och Microsoft.Data.SqlClient.Extensions.Azure. Applikationer som inte använder drivrutinsbaserad Microsoft Entra-autentisering behöver inte Azure-tilläggspaketet. För autentiseringsinstallation, se Microsoft Entra-autentisering.

Uppdatera drivrutinen

Innan du uppdaterar:

1. Läs Vad som är nytt i Microsoft. Data.SqlClient och upstream release notes för varje version som passeras av uppdateringen.

2. Kontrollera applikationens direkta och transitiva paketreferenser.

   dotnet list package --include-transitive
   

3. Uppdatera paketreferensen.

   dotnet add package Microsoft.Data.SqlClient --version <version>
   

4. Återställ, bygg och kör applikationens tester.

5. Testa anslutningsetablering, autentisering, certifikatvalidering, anslutningspoolning, datatypkonverteringar, transaktioner och återförsöksbeteende mot varje stödd databasmål.

Större och patch-släpp kan kräva applikationsändringar. Till exempel aktiverade version 4.0 kryptering som standard, version 5.0 ändrades SqlConnectionStringBuilder.Encrypt från bool till SqlConnectionEncryptOption, och version 7.0 flyttade drivrutinstillhandahållen Microsoft Entra-autentisering till ett separat paket.

Från och med version 7.0.2 ändrades assemblerversionerna av Microsoft.Data.SqlClient.Extensions.Azure, Microsoft.Data.SqlClient.Extensions.Abstractions, och Microsoft.Data.SqlClient.Internal.Logging från 1.0.0.0 till .7.0.0.0 .NET Framework-applikationer måste bygga om mot de justerade paketen eller lägga till bindningsomdirigeringar. Applikationer på nuvarande .NET påverkas inte av denna ändring av assembleridentitet.

Förstå målramverk

Microsoft. Data.SqlClient 7.0 stödjer applikationer på:

• .NET Framework 4.6.2 eller senare på Windows.
• .NET 8 eller senare på Windows-, Linux- och macOS-versionerna.

NuGet-paketet innehåller också en .NET Standard 2.0-kompatibilitetsresurs för bibliotek. En exekverbar applikation måste rikta in sig på en stödd .NET- eller .NET Framework-runtime. Ett biblioteks målplattform för .NET Standard innebär inte att alla körmiljöer som använder det stöds.

Paketet återställer sina hanterade och inbyggda beroenden med hjälp av NuGet. Kopiera inte enskilda drivrutinssammansättningar eller inbyggda SQL Network Interface-bibliotek (SNI) mellan applikationer.

Förbereda för distribution

1. Publicera för samma operativsystem och arkitektur som används i produktion. För en ramverksberoende distribution:

   dotnet publish --configuration Release
   

   För en körtidsspecifik distribution:

   dotnet publish --configuration Release --runtime <runtime-identifier>
   

2. Distribuera hela publiceringsresultatet. Välj inte bara Microsoft.Data.SqlClient.dll.

3. Kontrollera att målmiljön har den .NET-körmiljö som krävs om du inte publicerar ett fristående program.

4. Testa den publicerade versionen på måloperativsystemet och målarkitekturen.

5. Testa varje autentiseringsläge som används i produktion. Integrerad autentisering, Kerberos, certifikat, hanterad identitet och Azure Key Vault-åtkomst beror på distributionsmiljön.

6. Skanna den lösta beroendegrafen efter kända sårbarheter och uppdatera stödda paketrader när korrigeringar finns.

Globaliseringsinvariant läge stöds inte. För aktuella plattformskvalifikationer, se Stödda operativsystem.

Installation av offline-paket

Ladda ner paketet och dess beroenden från NuGet.org, kopiera dem till en intern paketkälla och återställ från den källan. För upprepbara offline-byggen, pinna paketversioner och bevara hela beroendeuppsättningen.

Relaterat innehåll

• Kom igång med SqlClient-drivrutinen
• Vad är nytt i Microsoft. Data.SqlClient
• Supportlivscykel för SqlClient-drivrutin
• Microsoft. Data.SqlClient-släpp