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. Den senaste GA-versionen är Microsoft.Data.SqlClient 7.1.1.

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>

Kommandot lägger till ett PackageReference element i din projektfil. För version 7.1.1 innehåller projektfilen denna rad:

<PackageReference Include="Microsoft.Data.SqlClient" Version="7.1.1" />

Om du också lägger till Microsoft.Data.SqlClient.Extensions.Azure, använder dess PackageReference samma version.

Återställ beroenden och bygg projektet:

dotnet restore
dotnet build

Om återställning eller bygg rapporterar en varning om ett paket med en känd sårbarhet, såsom NU1902 eller NU1903, följ stegen i Åtgärder när paket med kända sårbarheter rapporteras.

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.

Mer information finns i Installera och hantera paket i Visual Studio med hjälp av NuGet Správca balíkov.

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 konfiguration av autentisering, se Microsoft Entra-autentisering med Microsoft.Data.SqlClient.

Uppdatera drivrutinen

1. Innan du uppdaterar, kontrollera dessa punkter:

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

   • Lista applikationens direkta och transitiva paketreferenser:

     dotnet list package --include-transitive
     

   • Notera varje följeslagarpaket som applikationen refererar direkt till, såsom Microsoft.Data.SqlClient.Extensions.Azure eller Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider.

2. Uppdatera paketreferensen.

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

3. För version 7.0.2 och senare, uppdatera varje direkt refererat kompletterande paket till samma 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.1 stöder program på:

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

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.

.NET Framework-projekt

Exemplen i dessa artiklar riktar sig mot .NET. För ny utveckling, använd .NET istället för .NET Framework. För mer information, se Översikt av .NET Framework.

Projekt som riktar sig mot .NET Framework använder C# 7.3 som standard, så ett exempel skrivet för .NET kompileras inte där utan ändringar. Snabbstart: Koppla upp dig och fråga med Microsoft.Data.SqlClient har en flik för .NET Framework med en C# 7.3-version av sitt exempel.

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

• Snabbstart: Koppla upp och fråga med Microsoft.Data.SqlClient
• Snabbstart: Använd Microsoft. Data.SqlClient i en ASP.NET Core-app
• Vad är nytt i Microsoft. Data.SqlClient
• Supportlivscykel för SqlClient-drivrutin
• Microsoft. Data.SqlClient-släpp