Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Microsoft. Data.SqlClient ist der unterstützte .NET-Datenanbieter für SQL Server, Azure SQL-Datenbank, Azure SQL Managed Instance, Azure Synapse Analytics, SQL Database in Microsoft Fabric und Warehouse in Microsoft Fabric. Der Treiber wird als NuGet-Pakete unabhängig von der .NET-Laufzeit ausgeliefert.
Wählen Sie eine Veröffentlichung
Verwenden Sie eine unterstützte General Availability (GA)-Version für Produktionsanwendungen.
| Veröffentlichungslinie | Supportstufe | Wählen Sie diese Option, wenn |
|---|---|---|
| 7.0 | Standard Term Support (STS) | Du brauchst die aktuellen Treiberfunktionen und kannst bei der regulären Release-Frequenz aktualisieren. |
| 6.1 | Langfristiger Support (Long Term Support, LTS) | Du bevorzugst eine längere Supportzeit und brauchst keine Funktionen, die in 7.0 eingeführt wurden. |
Für aktuelle Patch-Versionen, Supportdaten, Zielframeworks und Datenbankkompatibilität siehe Lebenszyklus der SqlClient-Treiberunterstützung.
Installiere das Kernpaket
Führe folgenden Befehl aus dem Verzeichnis aus, das deine Projektdatei enthält:
dotnet add package Microsoft.Data.SqlClient
Der Befehl wählt die neueste stabile Version, die mit dem Projekt kompatibel ist. Um eine Version für wiederholbare Builds zu pinnen, spezifizieren Sie die Version:
dotnet add package Microsoft.Data.SqlClient --version <version>
Abhängigkeiten wiederherstellen und das Projekt aufbauen:
dotnet restore
dotnet build
Importiere den Treibernamensraum in C#:
using Microsoft.Data.SqlClient;
Für neue Anwendungen solltest du nicht auf das ältere Paket oder den Namensraum System.Data.SqlClient verweisen. Um eine bestehende Anwendung zu aktualisieren, siehe Migrate from System.Data.SqlClient to Microsoft. Data.SqlClient.
Installieren mit Visual Studio
- Im Projektmappen-Explorer klicken Sie mit der rechten Maustaste auf das Projekt und wählen Sie NuGet-Pakete verwalten.
- Im Reiter Durchsuchen , suchen Sie nach
Microsoft.Data.SqlClient. - Wählen Sie das Paket aus, das Microsoft gehört.
- Wählen Sie eine unterstützte stabile Version aus und wählen Sie dann Installieren.
Weitere Informationen finden Sie unter Install and manage Packages in Visual Studio.
Optionale Pakete hinzufügen
Installiere optionale Pakete nur, wenn deine Anwendung die zugehörige Funktion nutzt.
| Package | Füge es hinzu, wenn |
|---|---|
Microsoft.Data.SqlClient.Extensions.Azure |
Microsoft. Data.SqlClient 7.0 oder später verwendet einen vom Treiber bereitgestellten Microsoft Entra-Authentifizierungsmodus, wie Active Directory Default, Active Directory Interactive, oder Active Directory Managed Identity. |
Microsoft.Data.SqlClient.AlwaysEncrypted.AzureKeyVaultProvider |
Always Encrypted speichert Spalten-Masterschlüssel in Azure Key Vault. |
Für die Microsoft Entra-Authentifizierung mit SqlClient 7.0 oder neuer, führen Sie Folgendes aus:
dotnet add package Microsoft.Data.SqlClient.Extensions.Azure --version <same-version-as-Microsoft.Data.SqlClient>
Das 7.0-Kernpaket enthält keine Azure Identity-Abhängigkeiten mehr. Ab Version 7.0.2 verwenden der Kerntreiber und die Begleitpakete ausgerichtete Versionen. Beziehen Sie sich auf dieselbe Version von Microsoft.Data.SqlClient und Microsoft.Data.SqlClient.Extensions.Azure. Anwendungen, die keine treibergesteuerte Microsoft Entra-Authentifizierung verwenden, benötigen das Azure-Erweiterungspaket nicht. Für die Authentifizierungseinrichtung siehe Microsoft Entra-Authentifizierung.
Aktualisieren des Treibers
Vor dem Update:
Lesen Sie, was es Neues bei Microsoft gibt. Data.SqlClient und die Upstream-Release Notes für jede Version, die durch das Update gekreuzt wurde.
Überprüfen Sie die direkten und transitiven Paketreferenzen der Anwendung.
dotnet list package --include-transitiveAktualisieren Sie die Paketreferenz.
dotnet add package Microsoft.Data.SqlClient --version <version>Wiederherstellen, bauen und die Tests der Anwendung ausführen.
Testen Sie Verbindungsaufbau, Authentifizierung, Zertifikatsvalidierung, Verbindungspooling, Datentypkonvertierungen, Transaktionen und das Wiederholungsverhalten gegen jedes unterstützte Datenbankziel.
Major- und Patch-Releases können Änderungen an Anwendungen erfordern. Zum Beispiel aktivierte Version 4.0 standardmäßig die Verschlüsselung, Version 5.0 wechselte SqlConnectionStringBuilder.Encrypt von bool zu SqlConnectionEncryptOption, und Version 7.0 verschob die treibergesteuerte Microsoft Entra-Authentifizierung in ein separates Paket.
Ab Version 7.0.2 wurden die Assemblerversionen von Microsoft.Data.SqlClient.Extensions.Azure, , und Microsoft.Data.SqlClient.Internal.Logging von 1.0.0.07.0.0.0. Microsoft.Data.SqlClient.Extensions.Abstractions .NET Framework-Anwendungen müssen gegen die ausgerichteten Pakete neu aufbauen oder Bindungsumleitungen hinzufügen. Anwendungen auf aktuellem .NET sind von dieser Änderung der Assembleridentität nicht betroffen.
Verstehen Sie Zielrahmenwerke
Microsoft. Data.SqlClient 7.0 unterstützt Anwendungen auf:
- .NET Framework 4.6.2 oder später unter Windows.
- .NET 8 oder neuer unterstützte Windows-, Linux- und macOS-Versionen.
Das NuGet-Paket enthält außerdem ein .NET Standard 2.0 Kompatibilitätsasset für Bibliotheken. Eine ausführbare Anwendung muss eine unterstützte .NET- oder .NET-Framework-Laufzeit ansprechen. Das .NET Standard-Ziel einer Bibliothek unterstützt nicht jede verbrauchende Laufzeit.
Das Paket stellt seine verwalteten und nativen Abhängigkeiten über NuGet wieder her. Kopiere keine einzelnen Treiberassemblschaften oder native SQL Network Interface (SNI)-Bibliotheken zwischen Anwendungen.
Vorbereiten der Bereitstellung
Veröffentlichen Sie für dasselbe Betriebssystem und dieselbe Architektur, die in der Produktion verwendet wird. Für eine framework-abhängige Bereitstellung:
dotnet publish --configuration ReleaseFür eine laufzeitspezifische Bereitstellung:
dotnet publish --configuration Release --runtime <runtime-identifier>Stellen Sie die vollständige Veröffentlichungsausgabe bereit. Wählen Sie nicht nur
Microsoft.Data.SqlClient.dll.Bestätigen Sie, dass das Ziel die erforderliche .NET-Laufzeit hat, es sei denn, Sie veröffentlichen eine eigenständige Anwendung.
Teste die veröffentlichte Ausgabe auf dem Ziel-Betriebssystem und der Architektur.
Teste jeden in der Produktion verwendeten Authentifizierungsmodus. Integrierte Authentifizierung, Kerberos, Zertifikate, verwaltete Identität und Azure Key Vault-Zugriff hängen von der Bereitstellungsumgebung ab.
Scanne den gelösten Abhängigkeitsgraphen nach bekannten Schwachstellen und aktualisiere unterstützte Paketzeilen, sobald Korrekturen verfügbar sind.
Der Globalisierungsinvariantenmodus wird nicht unterstützt. Für aktuelle Plattformqualifikationen siehe Unterstützte Betriebssysteme.
Offline-Paketinstallation
Laden Sie das Paket und seine Abhängigkeiten von NuGet.org herunter, kopieren Sie sie in eine interne Paketquelle und stellen Sie sie von dieser Quellquelle wieder her. Für wiederholbare Offline-Builds werden Paketversionen gepinnt und die vollständige Abhängigkeitsmenge erhalten.