Suporte do SqlClient para LocalDB

Baixar ADO.NET

A partir do SQL Server 2012, uma versão leve do SQL Server, denominada LocalDB, está disponível. Este artigo descreve como conectar-se a um banco de dados do LocalDB.

Comentários

Para obter mais informações sobre o LocalDB, inclusive como instalá-lo e configurar sua instância do LocalDB, confira os Manuais Online do SQL Server.

Para resumir o que você pode fazer com o LocalDB:

• Crie e inicie instâncias do LocalDB com sqllocaldb.exe ou seu arquivo app.config.

• Use sqlcmd.exe para adicionar e modificar bancos de dados em uma instância do LocalDB. Por exemplo, sqlcmd -S (localdb)\myinst.

• Use a palavra-chave da cadeia de conexão AttachDBFilename para adicionar um banco de dados à instância do LocalDB. Ao usar AttachDBFilename, se você não especificar o nome do banco de dados com a palavra-chave da cadeia de conexão Database, o banco de dados será removido da instância do LocalDB quando o aplicativo for fechado.

• Especifique uma instância do LocalDB em sua cadeia de conexão. Por exemplo, o nome da instância é myInstance, a cadeia de conexão incluiria:

server=(localdb)\\myInstance  

User Instance=True não é permitido ao se conectar a um banco de dados LocalDB.

Você pode baixar LocalDB do Microsoft SQL Server 2012 Feature Pack. Se usar sqlcmd.exe para modificar dados na instância LocalDB, você precisará do sqlcmd do SQL Server 2012, que você também encontra no Feature Pack do SQL Server 2012.

Criar programaticamente uma instância nomeada

Aplica-se a: .NET Framework .NET Core .NET Standard

Um aplicativo pode criar uma instância nomeada e especificar um banco de dados da seguinte maneira:

• Especifique as instâncias LocalDB a serem criadas no arquivo app.config, da maneira a seguir. O número de versão da instância deve ser igual ao número de versão da sua instalação do 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>  
  

• Especifique o nome da instância que usa a palavra-chave da cadeia de conexão server. O nome da instância especificado na palavra-chave da cadeia de conexão server deve corresponder ao nome especificado no arquivo app.config.

• Use a palavra-chave da cadeia de conexão AttachDBFilename para especificar o arquivo .MDF.

Próximas etapas

• Recursos do SQL Server e ADO.NET