Partilhar via


Suporte SqlClient para LocalDB

Baixar ADO.NET

A partir do SQL Server 2012, está disponível uma versão leve do SQL Server, chamada LocalDB. Este artigo discute como se ligar a uma base de dados LocalDB.

Observações

Para mais informações sobre o LocalDB, incluindo como instalar o LocalDB e configurar a sua instância LocalDB, consulte SQL Server Books Online.

Para resumir o que pode fazer com o LocalDB:

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

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

  • Use a palavra-chave de cadeia de ligação AttachDBFilename para adicionar uma base de dados à sua instância do LocalDB. Ao usar AttachDBFilename, se não especificar o nome da base de dados com a Database palavra-chave string de ligação, a base de dados é removida da instância do LocalDB quando a aplicação fecha.

  • Especifique uma instância de LocalDB na sua cadeia de ligação. Por exemplo, se o nome da sua instância é myInstance, a cadeia de ligação incluiria:

server=(localdb)\\myInstance  

User Instance=True não é permitido ao ligar-se a uma base de dados LocalDB.

Pode descarregar o LocalDB do Microsoft SQL Server 2012 Feature Pack. Se usares sqlcmd.exe para modificar dados na tua instância do LocalDB, precisas do sqlcmd do SQL Server 2012, que também podes obter no SQL Server 2012 Feature Pack.

Crie programáticamente uma instância nomeada

Aplica-se a: .NET Framework

Uma aplicação pode criar uma instância nomeada e especificar uma base de dados da seguinte forma:

  • Especifique as instâncias do LocalDB a criar no ficheiro app.config, da seguinte forma. O número de versão da instância deve ser o mesmo que o 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 usando a server palavra-chave da cadeia de ligação. O nome da instância especificado na server palavra-chave string de ligação deve corresponder ao nome especificado no ficheiro app.config.

  • Utilize a palavra-chave de string de ligação AttachDBFilename para especificar o ficheiro .MDF.

Próximos passos