Compatibilidad con SqlClient para LocalDB

Use el paquete NuGet Microsoft.Data.SqlClient para conectarse a LocalDB, una versión ligera de SQL Server disponible en Windows. Use la autenticación integrada de Windows para los ejemplos de este artículo.

Observaciones

Para resumir lo que puede hacer con LocalDB:

  • Cree e inicie instancias de LocalDB con SqlLocalDB.exe.

  • Use sqlcmd.exe para agregar y modificar bases de datos en una instancia de LocalDB. Por ejemplo: sqlcmd -S (localdb)\myinst.

  • Utilice la palabra clave de cadena de conexión AttachDBFilename para agregar una base de datos a la instancia de LocalDB. Al usar AttachDBFilename, si no especifica el nombre de la base de datos con la palabra clave de cadena Database de conexión, la base de datos se quitará de la instancia de LocalDB cuando se cierre la aplicación.

  • Especifique una instancia de LocalDB en la cadena de conexión. Por ejemplo, el nombre de instancia es myInstance, la cadena de conexión incluiría:

    Server=(localdb)\myInstance;Database=<database>;Integrated Security=true;Encrypt=true

User Instance=True no está permitido al conectarse a una base de datos LocalDB.

Para obtener información sobre cómo instalar LocalDB, vea SQL Server Express LocalDB.

Creación de una instancia con nombre mediante programación

Microsoft. Data.SqlClient en .NET moderno no usa la sección de configuración de .NET Frameworksystem.data.localdb. Cree e inicie la instancia antes de que la aplicación abra una conexión:

SqlLocalDB.exe create myInstance
SqlLocalDB.exe start myInstance

Especifique el mismo nombre de instancia en la palabra clave de cadena de conexión Server. Para adjuntar un archivo de base de datos existente, establezca AttachDBFilename en la ruta de acceso completa del archivo y establezca Database en el nombre de la base de datos.

Para el desarrollo local con una instancia de LocalDB que no tiene un certificado de servidor de confianza, use Encrypt=true;TrustServerCertificate=true. Esta configuración cifra la conexión, pero omite la validación del certificado del servidor. Para las conexiones de producción remota, use Encrypt=true;TrustServerCertificate=false y configure un certificado de servidor en el que confía el cliente y que coincida con el nombre del servidor. Para obtener más información, consulte Cifrado y validación de certificados en Microsoft.Data.SqlClient.

Consulte también

  • Se actualizó por última vez el