Поддержка SqlClient для LocalDB

Используйте пакет NuGet Microsoft.Data.SqlClient для подключения к LocalDB — это упрощённая версия SQL Server, доступная в Windows. Используйте интегрированную проверку подлинности Windows для примеров, приведенных в этой статье.

Замечания

Чтобы подвести итоги того, что можно сделать с помощью LocalDB:

  • Создавайте и запускайте экземпляры LocalDB с помощью SqlLocalDB.exe.

  • Используйте sqlcmd.exe для добавления и изменения баз данных в экземпляре LocalDB. Например: sqlcmd -S (localdb)\myinst.

  • Используйте ключевое слово строки подключения AttachDBFilename, чтобы добавить базу данных в экземпляр LocalDB. При использовании AttachDBFilename, если не указать имя базы данных с Database ключевым словом строки подключения, база данных будет удалена из экземпляра LocalDB при закрытии приложения.

  • Укажите экземпляр LocalDB в строке подключения. Например, если имя экземпляра — myInstance, строка подключения будет включать:

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

User Instance=True запрещено при подключении к базе данных LocalDB.

Сведения об установке LocalDB см. в статье SQL Server Express LocalDB.

Программное создание именованного экземпляра

Microsoft. Data.SqlClient в современных .NET не использует раздел конфигурации .NET Frameworksystem.data.localdb. Создайте и запустите экземпляр до того, как приложение откроет соединение:

SqlLocalDB.exe create myInstance
SqlLocalDB.exe start myInstance

Укажите то же имя экземпляра в ключевом слове Server строки подключения. Чтобы подключить существующий файл базы данных, задайте AttachDBFilename полный путь к файлу и задайте Database имя базы данных.

Для локальной разработки с экземпляром LocalDB, который не имеет доверенного сертификата сервера, используйте Encrypt=true;TrustServerCertificate=true. Этот параметр шифрует подключение, но пропускает проверку сертификата сервера. Для подключений к удаленной производственной среде используйте Encrypt=true;TrustServerCertificate=false и настройте сертификат сервера, которому доверяет клиент и который соответствует имени сервера. Для получения дополнительной информации см. Шифрование и проверка сертификатов в Microsoft.Data.SqlClient.

См. также

  • Последнее обновление: