SqlClient-Unterstützung für LocalDB

In diesem Thema wird erläutert, wie eine Verbindung mit einer LocalDB-Datenbank hergestellt wird. LocalDB ist eine ressourcensparende Version von SQL Server.

Bemerkungen

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.

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

Programmgesteuertes Erstellen einer benannten Instanz

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="System.Data.LocalDBConfigurationSection,System.Data,Version=4.0.0.0,Culture=neutral,PublicKeyToken=b77a5c561934e089"/>  
      </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.

Siehe auch