Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Microsoft.Data.SqlClient è il provider di dati .NET supportato per SQL Server, database SQL di Azure, Istanza gestita di SQL di Azure, Azure Synapse Analytics, database SQL in Microsoft Fabric e data warehouse in Microsoft Fabric. Il driver viene fornito come pacchetti NuGet indipendentemente dal runtime .NET.
Seleziona una release
Utilizzare una release supportata di Disponibilità Generale (GA) per applicazioni di produzione.
| Linea di rilascio | Livello di supporto | Sceglilo quando |
|---|---|---|
| 7.0 | Supporto a Termine Standard (STS) | Hai bisogno delle funzionalità attuali dei driver e puoi aggiornare con la frequenza di rilascio regolare. |
| 6.1 | Supporto a lungo termine (LTS) | Preferisci un periodo di supporto più lungo e non hai bisogno che le funzionalità siano introdotte nella 7.0. |
Per le versioni attuali delle patch, le date di supporto, i framework target e la compatibilità con il database, vedi ciclo di vita del supporto driver SqlClient.
Installa il pacchetto core
Esegui il seguente comando dalla directory che contiene il file del tuo progetto:
dotnet add package Microsoft.Data.SqlClient
Il comando seleziona l'ultima versione stabile compatibile con il progetto. Per fissare una versione per build ripetibili, specifica la versione:
dotnet add package Microsoft.Data.SqlClient --version <version>
Ripristinare le dipendenze e costruire il progetto:
dotnet restore
dotnet build
Importa il namespace del driver in C#:
using Microsoft.Data.SqlClient;
Per le nuove applicazioni, non fare riferimento al vecchio System.Data.SqlClient pacchetto o allo spazio di nomi. Per aggiornare un'applicazione esistente, vedi Migra da System.Data.SqlClient a Microsoft. Data.SqlClient.
Installare con Visual Studio
- In Esplora soluzioni, clicca con il tasto destro sul progetto e seleziona Gestisci i pacchetti NuGet.
-
Nella scheda Naviga, cerca
Microsoft.Data.SqlClient. - Seleziona il pacchetto di proprietà di Microsoft.
- Seleziona una versione stabile supportata, poi seleziona Installa.
Per maggiori informazioni, consulta Installa e gestisci i pacchetti in Visual Studio.
Aggiungi pacchetti opzionali
Installa pacchetti opzionali solo quando la tua applicazione utilizza la funzione correlata.
| Package | Aggiungilo quando |
|---|---|
Microsoft.Data.SqlClient.Extensions.Azure |
Microsoft. Data.SqlClient 7.0 o versioni successive utilizzano una modalità di autenticazione Microsoft Entra fornita dal driver, come Active Directory Default, Active Directory Interactive, o Active Directory Managed Identity. |
Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider |
Always Encrypted memorizza le chiave master delle colonne in Azure Key Vault. |
Per l'autenticazione Microsoft Entra con SqlClient 7.0 o successivo, esegui:
dotnet add package Microsoft.Data.SqlClient.Extensions.Azure --version <same-version-as-Microsoft.Data.SqlClient>
Il pacchetto core 7.0 non include più le dipendenze di Azure Identity. A partire dalla versione 7.0.2, il driver base e i pacchetti companion utilizzano versioni allineate. Fai riferimento alla stessa versione di Microsoft.Data.SqlClient e Microsoft.Data.SqlClient.Extensions.Azure. Le applicazioni che non utilizzano l'autenticazione Microsoft Entra fornita dal driver non necessitano del pacchetto di estensione Azure. Per la configurazione dell'autenticazione, vedi l'autenticazione Microsoft Entra.
Aggiornare il driver
Prima di eseguire l'aggiornamento:
Leggi Novità di Microsoft.Data.SqlClient e le note sulla versione upstream per ogni versione interessata dall'aggiornamento.
Controlla i riferimenti diretti e transitivi dei pacchetti dell'applicazione.
dotnet list package --include-transitiveAggiorna il riferimento del pacco.
dotnet add package Microsoft.Data.SqlClient --version <version>Ripristinare, costruire ed eseguire i test dell'applicazione.
Verificare l'instaurazione della connessione, l'autenticazione, la validazione dei certificati, il pool di connessioni, le conversioni dei tipi di dati, le transazioni e il comportamento dei tentativi di ripetizione per ciascun database di destinazione supportato.
Le release principali e le patch possono richiedere modifiche alle applicazioni. Ad esempio, la versione 4.0 abilitava la crittografia di default, la versione 5.0 passava SqlConnectionStringBuilder.Encrypt da bool , SqlConnectionEncryptOptione la versione 7.0 spostava l'autenticazione Microsoft Entra fornita dal driver in un pacchetto separato.
A partire dalla versione 7.0.2, le versioni assembly di Microsoft.Data.SqlClient.Extensions.Azure, Microsoft.Data.SqlClient.Extensions.Abstractions, e Microsoft.Data.SqlClient.Internal.Logging sono passate da 1.0.0.0 a 7.0.0.0. Le applicazioni di .NET Framework devono essere ricompilate usando i pacchetti allineati oppure devono essere aggiunti i reindirizzamenti di binding. Le applicazioni basate sull'attuale .NET non sono interessate da questo cambiamento dell'identità dell'assembly.
Informazioni sui framework di destinazione
Microsoft. Data.SqlClient 7.0 supporta applicazioni su:
- .NET Framework 4.6.2 o successivo su Windows.
- .NET 8 o versioni successive supportavano Windows, Linux e macOS.
Il pacchetto NuGet contiene anche un asset di compatibilità .NET Standard 2.0 per librerie. Un'applicazione eseguibile deve essere destinata a un runtime supportato di .NET o di .NET Framework. Il target .NET Standard di una libreria non implica che ogni runtime che la utilizza sia supportato.
Il pacchetto ripristina le sue dipendenze gestite e native tramite NuGet. Non copiare singoli assembly di driver o librerie native dell'interfaccia di rete SQL (SNI) tra applicazioni.
Preparare la distribuzione
Pubblica per lo stesso sistema operativo e la stessa architettura usati in produzione. Per una distribuzione dipendente dal framework:
dotnet publish --configuration ReleasePer una distribuzione specifica del runtime:
dotnet publish --configuration Release --runtime <runtime-identifier>Distribuire l'output completo di pubblicazione. Non selezionare solo
Microsoft.Data.SqlClient.dll.Conferma che il target abbia il runtime .NET richiesto, a meno che tu non pubblichi un'applicazione autonoma.
Testa l'output pubblicato sul sistema operativo e sull'architettura di destinazione.
Testa ogni modalità di autenticazione utilizzata in produzione. Autenticazione integrata, Kerberos, certificati, identità gestita e accesso ad Azure Key Vault dipendono dall'ambiente di distribuzione.
Scansiona il grafo delle dipendenze risolte per vulnerabilità note e aggiorna le linee di pacchetto supportate quando sono disponibili correzioni.
La modalità invariante alla globalizzazione non è supportata. Per le qualifiche attuali delle piattaforme, vedi Sistemi operativi supportati.
Installazione offline del pacchetto
Scarica il pacchetto e le sue dipendenze da NuGet.org, copiali su una sorgente interna del pacchetto e ripristina da quella fonte. Per build offline ripetibili, blocca le versioni dei pacchetti e mantieni l'intero insieme delle dipendenze.