SqlClient-Unterstützung für LocalDB

Verwenden Sie das Microsoft.Data.SqlClient NuGet-Paket zum Herstellen einer Verbindung mit LocalDB, einer einfachen Version von SQL Server, die auf Windows verfügbar ist. Verwenden Sie Windows integrierte Authentifizierung für die Beispiele in diesem Artikel.

Bemerkungen

Sie können LocalDB für Folgendes nutzen:

  • Erstellen und starten Sie LocalDB-Instanzen mit SqlLocalDB.exe.

  • Verwenden Sie „sqlcmd.exe“, um Datenbanken in einer LocalDB-Instanz hinzuzufügen und zu ändern. Beispiel: sqlcmd -S (localdb)\myinst.

  • Verwenden Sie das AttachDBFilename-Schlüsselwort für eine Verbindungszeichenfolge, um eine Datenbank zu Ihrer LocalDB-Instanz hinzuzufügen. Wenn Sie beim Verwenden AttachDBFilenamedes Schlüsselworts "Verbindungszeichenfolge" den Namen der Datenbank Database nicht angeben, wird die Datenbank beim Schließen der Anwendung aus der LocalDB-Instanz entfernt.

  • Geben Sie in der Verbindungszeichenfolge eine LocalDB-Instanz an: Wenn Ihr Instanzname beispielsweise myInstance lautet, enthält die Verbindungszeichenfolge folgende Elemente:

    Server=(localdb)\myInstance;Database=<database>;Integrated Security=true;Encrypt=true

User Instance=True ist beim Herstellen einer Verbindung mit einer LocalDB-Datenbank nicht zulässig.

Informationen zum Installieren von LocalDB finden Sie unter SQL Server Express LocalDB.

Programmgesteuertes Erstellen einer benannten Instanz

Microsoft. Data.SqlClient für moderne .NET verwendet nicht den Konfigurationsabschnitt .NET Frameworksystem.data.localdb. Erstellen und starten Sie die Instanz, bevor Ihre Anwendung eine Verbindung öffnet:

SqlLocalDB.exe create myInstance
SqlLocalDB.exe start myInstance

Geben Sie denselben Instanznamen im Server Schlüsselwort "connection-string" an. Wenn Sie eine vorhandene Datenbankdatei anfügen möchten, legen Sie AttachDBFilename auf den vollständigen Pfad der Datei fest und setzen Sie Database auf den Datenbanknamen.

Verwenden Sie Encrypt=true;TrustServerCertificate=truefür die lokale Entwicklung mit einer LocalDB-Instanz, die kein vertrauenswürdiges Serverzertifikat hat. Diese Einstellung verschlüsselt die Verbindung, überspringt jedoch die Validierung des Serverzertifikats. Verwenden Sie für Remoteproduktionsverbindungen Encrypt=true;TrustServerCertificate=false und konfigurieren Sie ein Serverzertifikat, dem der Client vertraut und das mit dem Servernamen übereinstimmt. Weitere Informationen finden Sie unter Verschlüsselungs- und Zertifikatüberprüfung in Microsoft.Data.SqlClient.

Siehe auch