Suporte do SqlClient para LocalDB

Use o pacote NuGet Microsoft.Data.SqlClient para se conectar ao LocalDB, uma versão leve do SQL Server disponível no Windows. Use a autenticação integrada do Windows para os exemplos neste artigo.

Observações

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

  • Criar e iniciar instâncias do LocalDB com SqlLocalDB.exe.

  • 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 Database palavra-chave da cadeia de conexão, 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;Database=<database>;Integrated Security=true;Encrypt=true

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

Para obter informações sobre como instalar o LocalDB, consulte SQL Server Express LocalDB.

Criar programaticamente uma instância nomeada

Microsoft. Data.SqlClient no .NET moderno não usa a seção de configuração do .NET Frameworksystem.data.localdb. Crie e inicie a instância antes que seu aplicativo abra uma conexão:

SqlLocalDB.exe create myInstance
SqlLocalDB.exe start myInstance

Especifique o mesmo nome de instância na palavra-chave Server da cadeia de conexão. Para anexar um arquivo de banco de dados existente, defina AttachDBFilename como o caminho completo do arquivo e defina Database como o nome do banco de dados.

Para desenvolvimento local com uma instância do LocalDB que não tem um certificado de servidor confiável, use Encrypt=true;TrustServerCertificate=true. Essa configuração criptografa a conexão, mas ignora a validação do certificado do servidor. Para conexões de produção remotas, use Encrypt=true;TrustServerCertificate=false e configure um certificado de servidor em que o cliente confia e que corresponda ao nome do servidor. Para obter mais informações, consulte Criptografia e validação de certificado no Microsoft.Data.SqlClient.

Consulte também

  • Última atualização em