Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Microsoft. Data.SqlClient is de ondersteunde .NET-dataprovider voor SQL Server, Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, SQL database in Microsoft Fabric en Warehouse in Microsoft Fabric. De driver wordt als NuGet-pakketten verzonden, onafhankelijk van de .NET-runtime.
Kies een uitgave
Gebruik een ondersteunde General Availability (GA) release voor productieapplicaties.
| Uitgavelijn | Ondersteuningsniveau | Kies deze wanneer |
|---|---|---|
| 7.0 | Standaardtermijn Onderhoud (STS) | Je hebt actuele functies van stuurprogramma's nodig en kunt updates uitvoeren volgens het reguliere releaseschema. |
| 6.1 | Langetermijnondersteuning (LTS) | Je geeft de voorkeur aan een langere ondersteuningsperiode en hebt geen functies nodig die in 7.0 zijn geïntroduceerd. |
Voor huidige patchversies, ondersteuningsdata, doelframeworks en databasecompatibiliteit, zie levenscyclus van SqlClient-driver ondersteuning.
Installeer het kernpakket
Voer het volgende commando uit vanuit de map die je projectbestand bevat:
dotnet add package Microsoft.Data.SqlClient
Het commando selecteert de nieuwste stabiele versie die compatibel is met het project. Om een versie voor herhaalbare builds vast te pinnen, specificeer je de versie:
dotnet add package Microsoft.Data.SqlClient --version <version>
Herstel afhankelijkheden en bouw het project:
dotnet restore
dotnet build
Importeer de drivernaamruimte in C#:
using Microsoft.Data.SqlClient;
Voor nieuwe applicaties moet je niet naar het oudere pakket of de naamruimte System.Data.SqlClient verwijzen. Om een bestaande applicatie bij te werken, zie Migreren van System.Data.SqlClient naar Microsoft. Data.SqlClient.
Installeren met Visual Studio
- Klik in Solution Explorer met de rechtermuisknop op het project en selecteer NuGet Packages beheren.
- Zoek op het tabblad Bladeren naar
Microsoft.Data.SqlClient. - Selecteer het pakket dat eigendom is van Microsoft.
- Selecteer een stabiele versie die wordt ondersteund en selecteer vervolgens Installeren.
Voor meer informatie, zie Installeren en beheren pakketten in Visual Studio.
Voeg optionele pakketten toe
Installeer optionele pakketten alleen wanneer je applicatie de gerelateerde functie gebruikt.
| Package | Voeg het toe wanneer |
|---|---|
Microsoft.Data.SqlClient.Extensions.Azure |
Microsoft. Data.SqlClient 7.0 of later gebruikt een door de stuurprogramma geleverde Microsoft Entra-authenticatiemodus, zoals Active Directory Default, Active Directory Interactive, of Active Directory Managed Identity. |
Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider |
Always Encrypted slaat kolom-hoofdsleutels op in Azure Key Vault. |
Voor Microsoft Entra-authenticatie met SqlClient 7.0 of later, voer uit:
dotnet add package Microsoft.Data.SqlClient.Extensions.Azure --version <same-version-as-Microsoft.Data.SqlClient>
Het 7.0 core-pakket bevat geen Azure Identity-afhankelijkheden meer. Vanaf versie 7.0.2 gebruiken de kerndrivers en bijbehorende pakketten uitgelijnde versies. Verwijs naar dezelfde versie van Microsoft.Data.SqlClient en Microsoft.Data.SqlClient.Extensions.Azure. Applicaties die geen driver-geleverd Microsoft Entra-authenticatie gebruiken, hebben het Azure-extensiepakket niet nodig. Voor authenticatie-instelling, zie Microsoft Entra authenticatie.
Het stuurprogramma bijwerken
Voordat u de update uitvoert:
Lees Wat is er nieuw in Microsoft. Data.SqlClient en de upstream release notes voor elke versie die door de update is gekruist.
Controleer de directe en transitieve pakketreferenties van de applicatie.
dotnet list package --include-transitiveWerk de pakketreferentie bij.
dotnet add package Microsoft.Data.SqlClient --version <version>Herstel, bouw en voer de tests van de applicatie uit.
Test verbindingsopbouw, authenticatie, certificaatvalidatie, verbindingspooling, datatypeconversies, transacties en herkansingsgedrag tegen elk ondersteund databasedoel.
Grote en patchreleases kunnen applicatiewijzigingen vereisen. Zo maakte versie 4.0 standaard encryptie mogelijk, versie 5.0 veranderde SqlConnectionStringBuilder.Encrypt van boolSqlConnectionEncryptOptionnaar , en verplaatste versie 7.0 de door de drivers geleverde Microsoft Entra-authenticatie naar een apart pakket.
Vanaf versie 7.0.2 veranderden de assemblyversies van Microsoft.Data.SqlClient.Internal.Logging, 1.0.0.0 en 7.0.0.0 van Microsoft.Data.SqlClient.Extensions.Abstractions naar Microsoft.Data.SqlClient.Extensions.Azure. .NET Framework-applicaties moeten opnieuw worden gecompileerd met de afgestemde pakketten of binding redirects toevoegen. Applicaties op de huidige .NET worden niet beïnvloed door deze wijziging van assembly-identiteit.
Doelframeworks begrijpen
Microsoft. Data.SqlClient 7.0 ondersteunt applicaties op:
- .NET Framework 4.6.2 of later op Windows.
- .NET 8 of later ondersteunde Windows-, Linux- en macOS-versies.
Het NuGet-pakket bevat ook een .NET Standard 2.0-compatibiliteitsasset voor bibliotheken. Een uitvoerbare applicatie moet gericht zijn op een ondersteunde .NET- of .NET Framework-runtime. Het .NET Standard-doel van een bibliotheek zorgt er niet voor dat elke verbruikende runtime wordt ondersteund.
Het pakket herstelt zijn beheerde en native afhankelijkheden via NuGet. Kopieer geen individuele driverassemblies of native SQL Network Interface (SNI)-bibliotheken tussen applicaties.
Implementatie voorbereiden
Publiceren voor hetzelfde besturingssysteem en dezelfde architectuur die in productie wordt gebruikt. Voor een framework-afhankelijke implementatie:
dotnet publish --configuration ReleaseVoor een runtime-specifieke implementatie:
dotnet publish --configuration Release --runtime <runtime-identifier>Verspreid de volledige publicatie-output. Selecteer niet alleen
Microsoft.Data.SqlClient.dll.Bevestig dat het doelwit de vereiste .NET-runtime heeft, tenzij je een zelfstandige applicatie publiceert.
Test de gepubliceerde uitvoer op het beoogde besturingssysteem en de bijbehorende architectuur.
Test elke authenticatiemodus die in productie wordt gebruikt. Geïntegreerde authenticatie, Kerberos, certificaten, beheerde identiteit en toegang tot Azure Key Vault zijn afhankelijk van de implementatieomgeving.
Scan de opgeloste afhankelijkheidsgrafiek op bekende kwetsbaarheden en werk ondersteunde pakketregels bij wanneer er oplossingen beschikbaar zijn.
De globaliseringsinvariante modus wordt niet ondersteund. Voor huidige platformkwalificaties, zie Ondersteunde besturingssystemen.
Offline installatie van pakketten
Download het pakket en de afhankelijkheden van NuGet.org, kopieer ze naar een interne pakketbron en herstel vanaf die bron. Voor herhaalbare offline builds zet je pakketversies vast en behoud je de volledige set afhankelijkheden.