SqlClient 对 LocalDB 的支持

下载 ADO.NET

从 SQL Server 2012 开始提供 SQL Server 的称作 LocalDB 的轻型版本。 本文讨论如何连接到 LocalDB 数据库。

注解

有关 LocalDB 的详细信息(包括如何安装 LocalDB 和配置 LocalDB 实例),请参阅 SQL Server 联机丛书。

若要汇总可通过 LocalDB 执行的操作:

  • 使用 sqllocaldb 或 app.config 文件创建和启动 LocalDB 实例。

  • 使用 sqlcmd.exe 添加和修改 LocalDB 实例中的数据库。 例如 sqlcmd -S (localdb)\myinst

  • 使用 AttachDBFilename 连接字符串关键字将数据库添加到 LocalDB 实例。 在使用 AttachDBFilename 时,如果你没有使用 Database 连接字符串关键字指定数据库的名称,则在应用程序关闭时,将从 LocalDB 实例中删除该数据库。

  • 在连接字符串中指定 LocalDB 实例。 例如,实例名称为 myInstance,连接字符串将包括:

server=(localdb)\\myInstance  

连接到 LocalDB 数据库时不允许使用 User Instance=True

可以从 Microsoft SQL Server 2012 功能包下载 LocalDB。 如果使用 sqlcmd.exe 来修改 LocalDB 实例中的数据,则需要 SQL Server 2012 中的 sqlcmd,你也可以从 SQL Server 2012 功能包中获得它。

以编程方式创建命名实例

适用于: .NET Framework 不支持。 .NET Core 不支持。 .NET Standard

应用程序可以创建命名实例并指定数据库,如下所示:

  • 在 app.config 文件中指定要创建的 LocalDB 实例,如下所示。 实例的版本号应与 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>  
    
  • 使用 server 连接字符串关键字指定实例的名称。 server 连接字符串关键字中指定的实例名称必须与 app.config 文件中指定的名称匹配。

  • 使用 AttachDBFilename 连接字符串关键字来指定 .MDF 文件。

后续步骤