SqlClient-Unterstützung für LocalDB

Herunterladen von ADO.NET

Ab SQL Server 2012 ist eine vereinfachte Version von SQL Server mit dem Namen LocalDB verfügbar. In diesem Thema wird erläutert, wie eine Verbindung mit einer LocalDB-Datenbank hergestellt wird.

Hinweise

Weitere Informationen zu LocalDB, einschließlich der Installation von LocalDB und der Konfiguration der LocalDB-Instanz, finden Sie in der SQL Server-Onlinedokumentation.

Sie können LocalDB für Folgendes nutzen:

• Erstellen und Starten von LocalDB-Instanzen mit einer sqllocaldb.exe- oder einer app.config-Datei

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

• Verwenden des AttachDBFilename-Schlüsselworts für eine Verbindungszeichenfolge zum Hinzufügen einer Datenbank zu Ihr LocalDB-Instanz. Wenn Sie AttachDBFilename verwenden und den Namen der Datenbank nicht mit dem Schlüsselwort der Database-Verbindungszeichenfolge angeben, wird die Datenbank aus der LocalDB-Instanz entfernt, wenn die Anwendung geschlossen wird.

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

server=(localdb)\\myInstance  

User Instance=True ist nicht zulässig, wenn eine Verbindung mit einer LocalDB-Datenbank hergestellt wird.

Sie können LocalDB aus dem Microsoft SQL Server 2012 Feature Pack herunterladen. Wenn Sie sqlcmd.exe verwenden, um Daten in der LocalDB-Instanz zu ändern, benötigen Sie sqlcmd von SQ 2012, das auch aus dem SQL Server 2012 Feature Pack abrufbar ist.

Programmgesteuertes Erstellen einer benannten Instanz

Gilt für: .NET Framework .NET Core .NET Standard

Eine Anwendung kann wie folgt eine benannte Instanz erstellen und eine Datenbank angeben:

• Geben Sie wie folgt die LocalDB-Instanzen an, die in der Datei „app.config“ erstellt werden sollen. Die Versionsnummer der Instanz sollte mit der Versionsnummer der LocalDB-Installation identisch sein.

  <?xml version="1.0" encoding="utf-8" ?>  
  <configuration>  
    <configSections>  
      <section  
      name="system.data.localdb"  
      type="Microsoft.Data.LocalDBConfigurationSection,Microsoft.Data.SqlClient, Version=5.0.0.0, Culture=neutral, PublicKeyToken=23ec7fc2d6eaa4a5"/>  
    </configSections>  
    <system.data.localdb>  
      <localdbinstances>  
        <add name="myInstance" version="11.0" />  
      </localdbinstances>  
    </system.data.localdb>  
  </configuration>  
  

• Geben Sie den Namen der Instanz mithilfe des Schlüsselworts server für die Verbindungszeichenfolge an. Der im server-Schlüsselwort für die Verbindungszeichenfolge angegebene Instanzname muss mit dem Namen übereinstimmen, der in der Datei app.config angegeben ist.

• Verwenden Sie das Schlüsselwort AttachDBFilename für die Verbindungszeichenfolge, um die MDF-Datei anzugeben.

Nächste Schritte

• SQL Server-Features und ADO.NET