Prise en charge par SqlClient de LocalDB

Télécharger ADO.NET

À compter de SQL Server 2012, une version légère de SQL Server, appelée LocalDB, est disponible. Cet article explique comment se connecter à une base de données LocalDB.

Notes

Pour plus d’informations sur LocalDB, notamment comment installer LocalDB et configurer votre instance LocalDB, consultez la Documentation en ligne de SQL Server.

Pour résumer ce que vous pouvez faire avec LocalDB :

• Créez et démarrez des instances de LocalDB avec sqllocaldb.exe ou votre fichier app.config.

• Utilisez sqlcmd.exe pour ajouter et modifier des bases de données dans une instance LocalDB. Par exemple : sqlcmd -S (localdb)\myinst.

• Utilisez le mot clé de chaîne de connexion AttachDBFilename pour ajouter une base de données à votre instance LocalDB. Quand vous utilisez AttachDBFilename, si vous ne spécifiez pas le nom de la base de données avec le mot clé de chaîne de connexion Database, la base de données est supprimée de l’instance LocalDB quand l’application se ferme.

• Spécifiez une instance LocalDB dans votre chaîne de connexion. Par exemple, si le nom de votre instance est myInstance, la chaîne de connexion inclut les éléments suivants :

server=(localdb)\\myInstance  

User Instance=True n’est pas autorisé lors de la connexion à une base de données LocalDB.

Vous pouvez télécharger LocalDB à partir de Microsoft SQL Server 2012 Feature Pack. Si vous utilisez sqlcmd.exe pour modifier des données dans votre instance de LocalDB, vous avez besoin du sqlcmd de SQL Server 2012 que vous pouvez également obtenir dans SQL Server 2012 Feature Pack.

Créer par programme une instance nommée

S’applique à : .NET Framework .NET Core .NET Standard

Une application peut créer une instance nommée et spécifier une base de données comme suit :

• Spécifiez les instances LocalDB à créer dans le fichier app.config, comme suit. Le numéro de version de l’instance doit être le même que le numéro de version de votre installation de LocalDB.

  <?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>  
  

• Spécifiez le nom de l’instance à l’aide du mot clé de chaîne de connexion server. Le nom de l’instance spécifié dans le mot clé de chaîne de connexion server doit correspondre au nom spécifié dans le fichier app.config.

• Utilisez le mot clé de chaîne de connexion AttachDBFilename pour spécifier le fichier .MDF.

Étapes suivantes

• Fonctionnalités de SQL Server et ADO.NET