Sql server compact edition windows 10

Despite the age and soon complete end of support in July 2021 of SQL Server Compact 4 (launched in 2010), some (actually few) wonder if it is possible to use it with .NET Core. I will show how this can be done here.

These are the high-level steps required to achieve this:

• Install the SQL Server Compact 4.0 run-time (included in the repository linked below).

• Create a new executable .NET Core 3.1 project (Console App, WinForm, WPF, Windows Service).

• Set the project to Target x64:

    <PropertyGroup>
      <OutputType>Exe</OutputType>
      <TargetFramework>netcoreapp3.1</TargetFramework>
      <Platforms>x64</Platforms>
    </PropertyGroup>

• Copy the System.Data.SqlServerCe.dll file and the entire amd64 folder from the C:Program FilesMicrosoft SQL Server Compact Editionv4.0Private directory to the folder where the .csproj file created above is located.

• Mark all the 10 copied files a Content, Copy Always, like this one:

    <ItemGroup>
      <None Remove="System.Data.SqlServerCe.dll" />
    </ItemGroup>
    
    <ItemGroup>
      <Content Include="System.Data.SqlServerCe.dll">
        <CopyToOutputDirectory>Always</CopyToOutputDirectory>
      </Content>
    </ItemGroup>

• Add a file reference to the System.Data.SqlServerCe.dll file in the root of your project:

    <ItemGroup>
        <Reference Include="System.Data.SqlServerCe">
          <HintPath>System.Data.SqlServerCe.dll</HintPath>
        </Reference>
    </ItemGroup>

• Install the Windows compatibility pack, to make any required Windows specific .NET APIs available.

    <ItemGroup>
      <PackageReference Include="Microsoft.Windows.Compatibility" Version="3.1.1" />
    </ItemGroup>

• Finally write some code, and use the System.Data.SqlServerCe name space:

    using System.Data.SqlServerCe;
   
    ...
    var dbFile = "netcore-sqlce.sdf";
    var connectionString = $"Data Source={dbFile}";
     
    using SqlCeEngine engine = new SqlCeEngine(connectionString);
    engine.CreateDatabase();

Your app now includes a complete file based RDBMS, and you can XCOPY deploy the project to any Windows machine, all that is required in the .NET Core 3.1 run-time.

You can see (and clone and run) a complete solution from the GitHub repository here, which also contains an installer for the latest SQL Server Compact 4.0 run-time.

Comments or questions for this blog post?

From Wikipedia, the free encyclopedia

Microsoft SQL Server Compact (EOL, See SQL Express) (SQL CE) is a compact relational database produced by Microsoft for applications that run on mobile devices and desktops. Prior to the introduction of the desktop platform, it was known as SQL Server for Windows CE and SQL Server Mobile Edition.

It includes both 32-bit and 64-bit native support.^[1] SQL CE targets occasionally connected applications and applications with an embedded database.^[2] It is free to download and redistribute.^[2] An ODBC driver for SQL CE does not exist, nor is one planned. Native applications may use SQL CE via OLE DB.

The latest, and last, release is the SQL Server Compact 4.0.^[1] In February 2013 SQL Server Compact Edition had been deprecated; no new versions or updates are planned, although Microsoft continued to support the product until July 2021.^[3]

Overview[edit]

SQL Server Compact shares a common API with the other Microsoft SQL Server editions.^[4] It also includes ADO.NET providers for data access using ADO.NET APIs, and built-in synchronization capabilities,^[2] as well as support for LINQ and Entity Framework. Future releases will unify the synchronization capabilities with Microsoft Synchronization Services.^[5] Unlike other editions of Microsoft SQL Server, SQL CE runs in-process^[5] with the application which is hosting it. It has a disk footprint of less than 2 MB and a memory footprint of approximately 5 MB.^[2] SQL CE is optimized for an architecture where all applications share the same memory pool.^[6]
Windows Store apps for Windows 8 cannot use SQL Server Compact edition, or any other edition of SQL Server.^[7]

Support[edit]

SQL CE databases can support ACID-compliance, but do not meet the durability requirement by default because AutoFlush buffers changes in memory (including enlisted ambient transactions and explicit SQL CE transactions that do not override the Commit() call with an CommitMode.Immediate value). Therefore, committed transaction changes can be lost. To meet the durability requirement the commit call on the transaction must specify the immediate flag.^[13] Like Microsoft SQL Server, SQL CE supports transactions, referential integrity constraints, locking as well as multiple connections to the database store.^[4] However, nested transactions are not supported, even though parallel transactions (on different tables) are.^[14] The current release does not support stored procedures^[4] or native XML data type either.^[5] It uses a subset of T-SQL^[2] for querying and due to lack of XML support, XQuery is not supported either.^[5] Queries are processed by an optimizing query processor.^[15] SQL CE databases also support indexing, as well as support remote data replication (local caching of data in remote databases) and merge replication (bidirectional synchronization with master databases).^[16]

SQL CE databases can be created and managed from Microsoft Visual Studio and some older versions of SQL Server Management Studio as well.^[15]

File format[edit]

SQL CE databases reside in a single .sdf file,^[17] which can be up to 4 GB in size.^[4] The .sdf file can be encrypted with 128-bit encryption for data security.^[17] SQL CE runtime mediates concurrent multi-user access to the .sdf file. The .sdf file can simply be copied to the destination system for deployment, or be deployed through ClickOnce. SQL CE runtime has support for DataDirectories.^[6] Applications using an SQL CE database need not specify the entire path to an .sdf file in the ADO.NET connection string, rather it can be specified as |DataDirectory|<database_name>.sdf, defining the data directory (where the .sdf database file resides) being defined in the assembly manifest for the application.^{[citation needed]}

SQL Server Management Studio 2005 can read and modify CE 3.0 and 3.1 database files (with the latest service pack), but SQL Server Management Studio 2008 (or later) is required to read version 3.5 files. Microsoft Visual Studio Express 2008 SP1 can create, modify, and query CE 3.5 SP1 database files. SQL Server Management Studio cannot read CE 4.0 files. Visual Studio 2010 SP1 can handle CE 4.0 database files.^{[citation needed]}

The .sdf («Sqlce Database File») naming convention is optional, and any extension can be used.^{[citation needed]}

Setting a password for the database file is optional. The database can be compressed and repaired with the option of the compacted/repaired database to be placed into a new database file.^{[citation needed]}

Deprecation[edit]

In February 2013, Microsoft announced that SQL Server Compact Edition had been deprecated.^[18]

Although no new versions or updates are planned, Microsoft will continue to support SQL Compact through their standard lifecycle support policy. Extended support for SQL Server Compact 4.0 ended on July 13, 2021.^[19]

See also[edit]

• Mobile database
• SQLite
• SQL Server Express § LocalDB
• Access Database Engine (ACE and formerly JET)
• HSQLDB
• Firebird

References[edit]

External links[edit]

• SQL Server Compact 3.5
• SQL Server Compact Release Versions
• Microsoft’s Embedded Database — SQL Server Compact — Team Blog

В этой статье я опишу упрощенный подход к частному развертыванию SQL Server Compact, а обзорную публикацию в блоге о частном развертывании с SQL Server Compact см. В моем  блоге здесь .

Заставляя ваше приложение работать с использованием x86 всегда (предпочтительно 32-разрядного), который является новым целевым параметром Platform для приложений, нацеленных на .NET Framework 4.5, развертывание SQL Server Compact с вашим приложением становится проще, но оно должно следовать другим рекомендациям, чем Я ранее писал о. (Тот же подход будет работать и с приложениями, ориентированными на .NET 4.0, просто установите целевую платформу на x86 в указанном ниже месте. И тот же подход будет работать и с DLL-файлами SQL Server Compact 3.5.)

Чтобы узнать больше о новой целевой опции платформы по умолчанию, представленной в .NET 4.5, см.  Документацию MSDN  здесь и пост в  блоге здесь .

Кроме того, я покажу, как использовать LINQ to SQL с SQL Server Compact 4.0, с низкими издержками и быстродействующим ORM.

Для простоты и для того, чтобы сосредоточить внимание на аспектах частного развертывания, я продемонстрирую на консольном приложении, но тот же подход будет работать и для приложений WinForms и WPF.

Прежде чем начать, убедитесь, что у вас установлено следующее:

1: Visual Studio 2010/2012/2013 Pro или выше 

2: надстройка SQL Server Compact Toolbox (установка через инструменты / расширения в VS)

3: Существующий файл базы данных SQL Server Compact, я буду использовать Chinook, который вы можете  скачать здесь . 

4. Среда выполнения SQL Server Compact  4.0 с пакетом обновления 1 (SP1)

(Вы также можете использовать бесплатную Visual Studio 2010/2012/2013 для Windows Desktop с автономной SQL Server Compact Toolbox для 4.0, которая также поддерживает генерацию кода LINQ to SQL)

После этого давайте откроем Visual Studio и начнем:

Создать новое консольное приложение

Перейдите в Файл, Новый проект и создайте новое консольное приложение Windows. Обязательно установите целевую платформу на 4.0 или новее.

Включите двоичные файлы SQL Server Compact в свой проект

Теперь включите двоичные файлы SQL Server Compact 4.0 и ADO.NET Provider в свое содержимое. Скопируйте C: Program Files (x86) Microsoft SQL Server Compact Edition v4.0 Private System.Data.SqlServerCe.dll в папку проекта, а затем скопируйте все файлы и папки в C: Program Files (x86). Microsoft SQL Server Compact Edition v4.0 Private x86 также в папку вашего проекта.

В обозревателе решений выберите Показать все файлы и включите новую папку и семь файлов, только что скопированных в проект:

Теперь отметьте все скопированные файлы (также файлы в папке Microsoft.VC9.CRT) и отметьте их как «Содержимое, всегда копировать»:

Наконец, добавьте ссылку на файл System.Data.SqlServerCe.dll в папке вашего проекта:

(Обязательно проверьте местоположение файла и версию, должна быть 4.0.0.1)

Добавьте файл вашей базы данных в проект

Убедитесь, что это также содержимое, всегда копируйте — здесь мы используем рабочий процесс «Сначала база данных».

Создайте LINQ to SQL DataContext

Далее мы создадим класс LINQ to SQL DataContext и связанные с ним классы таблиц на основе базы данных, поэтому подключитесь к базе данных в SQL Server Compact Toolbox, используя пункт меню Добавить соединение SQL Server Compact 4.0:

Затем щелкните правой кнопкой мыши базу данных и выберите «Добавить LINQ to SQL DataContext в текущий проект»:

(Я просто использую ChinookContext в качестве имени контекста)

Нажмите кнопку ОК, и файл класса DataContext будет добавлен в ваш проект, а в проект будет добавлена ​​необходимая ссылка на System.Data.Linq.

Теперь давайте добавим некоторый тестовый код в метод Main, чтобы убедиться, что все работает до сих пор, поэтому код Program.cs выглядит следующим образом:

using System;
using System.Data.SqlServerCe;

namespace LinqToSqlCePrivateDeploy
{
    class Program
    {
        private const string 
            dbFileName = "Chinook_SqlServerCompact_AutoIncrementPKs.sdf";
        
        private static string dbConnectionString = 
            string.Format("Data Source=|DataDirectory|{0};Max Database Size=4091", dbFileName);
        static void Main(string[] args)
        {
            using (var connection = 
                new SqlCeConnection(dbConnectionString))
            {
                using (var context = new ChinookContext(connection))
                {
                    //To log SQL statements, use:
                    //context.Log = Console.Out;
                    foreach (var album in context.Album)
                    {
                        Console.WriteLine(album.Artist.Name);
                        Console.WriteLine(album.Title);
                    }
                }
            }
            Console.Read();
        }
    }
}

Теперь мы можем получить доступ к базе данных через сгенерированную объектную модель, и нам не нужно вводить SQL, но мы можем использовать LINQ для запроса к базе данных. Кроме того, мы можем обновить базу данных (INSERT, UPDATE, DELETE) с помощью методов в DataContext. 

Обратите внимание, что DataContext  должен  быть создан с помощью объекта SqlCeConnection, чтобы LINQ to SQL мог работать с SQL Server Compact 4.0. 

Развернуть файл базы данных 

Последний шаг будет сделан, чтобы гарантировать, что файл базы данных будет расположен в доступной для записи папке на компьютере пользователя при развертывании / установке. Мы просто сделаем это в коде, чтобы не зависеть от действий и проблем при установке. Кроме того, мы можем сделать это без сохранения каких-либо строк подключения в app.config, что делает приложение более автономным. Мы будем использовать тот же подход, который я уже использовал в своем  блоге,  который использует макрос строки подключения DataDirectory.

private static void CreateIfNotExists(string fileName)
{
    string path = Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData);
    // Set the data directory to the users %AppData% folder 
    // So the database file will be placed in: C:\Users\<Username>\AppData\Roaming\ 
    AppDomain.CurrentDomain.SetData("DataDirectory", path);
            
    // Enure that the database file is present
    if (!System.IO.File.Exists(System.IO.Path.Combine(path, fileName)))
    {
        //Get path to our .exe, which also has a copy of the database file
        var exePath = System.IO.Path.GetDirectoryName(
            new Uri(System.Reflection.Assembly.GetExecutingAssembly().CodeBase).LocalPath);
        //Copy the file from the .exe location to the %AppData% folder
        System.IO.File.Copy(
            System.IO.Path.Combine(exePath, fileName), 
            System.IO.Path.Combine(path, fileName));
    }
}

Не забудьте добавить вызов CreateIfNotExists в качестве первой строки в методе Main:

static void Main(string[] args)
{
    CreateIfNotExists(dbFileName);

Теперь вы можете использовать ClickOnce, XCopy или Installer для развертывания приложения без каких-либо других требований, кроме целевой версии .NET Framework.

Чего мы достигли:

— Простое автономное развертывание однопользовательского настольного приложения любого типа на любой платформе .NET 4.0 или более поздней версии (но не ARM)

— Нет необходимости в специальных заклинаниях в app.config

— RAD (Rapid App Development) «Database First» доступ к хорошо работающей, хорошо документированной и простой ORM.

Вы можете скачать полное решение здесь; http://sdrv.ms/179QBaa