В некоторых проектах достаточно часто возникает необходимость в хранении данных, объем которых уже нельзя назвать маленьким, но в тоже время использовать какую-либо СУБД слишком накладно из-за сложности развертывания приложения. И тут на помощь приходит такая прекрасная вещь как SQLite – компактная встраиваемая база данных.
С чего начать
Если вы используете среду разработки Visual Studio (в частности версию 2008), то вам может так же пригодиться SQLite Designer, который дает возможность использовать визуальные средства для работы с базами SQLite: построитель запросов (Query Builder), редактирование таблиц и ряд других возможностей.
Ну и в дополнение ко всему в поставку библиотеки провайдера входит сборка System.Data.SQLite.Linq.dll, которая обеспечивает доступ к технологии LINQ.
Создание базы данных SQLite
Создавать базу данных SQLite можно как программным способом, так и используя Server Explorer, который доступен в Visual Studio. Рассмотрим программный способ создание базы данных с использованием провайдера ADO.NET. В качестве самого простого примера я создам базу и одну таблицу, в которой будет хранятся данные о рабочих абстрактной фирмы.
Создание базы и таблицы средствами ADO.NET:
using System;
using System.IO;
using System.Data;
using System.Data.Common;
using System.Data.SQLite;
class Program
<
static void Main( string [] args)
<
string baseName = «CompanyWorkers.db3» ;
SQLiteFactory factory = (SQLiteFactory)DbProviderFactories.GetFactory( «System.Data.SQLite» );
using (SQLiteConnection connection = (SQLiteConnection)factory.CreateConnection())
<
connection.ConnectionString = «Data Source = » + baseName;
connection.Open();
В этом примере используются классы SQLiteFactory, SQLiteConnection, SQLiteCommand, которые обеспечивают создание файла базы, подключение к источнику данных и выполнение SQL запросов. Эти классы и реализуют поддержку интерфейсов ADO.NET посредствам наследования базовых абстрактных классов ADO.NET, это можно увидеть, если посмотреть на их прототипы в Object Browser. Вот некоторые из них:
public sealed class SQLiteFactory : DbProviderFactory, IServiceProvider
public sealed class SQLiteConnection : DbConnection, ICloneable
Так, класс SQLiteFactory реализует функционал DbProviderFactory, а SQLiteConnection – DbConnection. Классы DbProviderFactory и DbConnection являются частью стандартных абстрактных классов ADO.NET, интерфейсы которых обеспечивают унифицированный доступ к данным вне зависимости от используемой СУБД.
Убедиться в том, что база в действительности была создана можно с помощью уже упомянутого Server Explorer, просто создав соединение к файлу базы:
Рис. 1. Просмотр базы данных CompanyWorkers через Server Explorer
В целом провайдер для SQLite реализует весь функционал, который необходим для работы с базами как на связанном, так и несвязанном уровнях ADO.NET.
Редактирование базы данных SQLite
Редактирования базы данных рассмотрим на примере простейшего приложения Web Forms. В целом, работа с SQLite в данном случае мало отличается от работы с другой СУБД, в силу использования интерфейса ADO.NET.
using System;
using System.Collections;
using System.Configuration;
using System.Data;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using DataEditor.CompanyWorkersTableAdaptersTableAdapters;
protected void DetailsView1_ItemDeleted( object sender, DetailsViewDeletedEventArgs e)
<
GridViewDataBind();
>
protected void DetailsView1_ItemUpdated( object sender, DetailsViewUpdatedEventArgs e)
<
GridViewDataBind();
>
protected void DetailsView1_ItemInserted( object sender, DetailsViewInsertedEventArgs e)
<
GridViewDataBind();
>
>
>
Теперь приложение полностью готово к использованию. Окончательный вид редактора для редактирование таблицы workers из базы CompanyWorkers.db3:
Рис. 5. Редактор, готовый к работе.
Благодаря использованию SQLite мне не понадобилось разворачивать каких-либо служб для работы с базой.
Заключение
Думаю, возможностей SQLite должно хватить для достаточного обширного круга задач. В тоже время не стоит пытаться использовать её в каких-либо серьёзных проектах с очень большими объёмами данных и большим количеством пользователей, так как данная СУБД для этого не предназначена: в ней отсутствует поддержка многопроцессорности и ограничены уровни изоляций для транзакций. В общем, для средних проектов, типа базы данных небольшой компании или телефонного справочника, самое подходящее средство.
Использование базы данных SQLite в приложении UWP
SQLite можно использовать для хранения и извлечения данных из упрощенной базы данных на устройстве пользователя. Это руководство содержит соответствующие инструкции.
Некоторые преимущества использования SQLite для локального хранения данных
✔️ SQLite легкая и автономная. Это библиотека кода без других зависимых компонентов. Ее не требуется настраивать.
✔️ Тут нет сервера базы данных. Клиент и сервер работают в одном процессе.
✔️ База данных SQLite находится в общедоступном домене, поэтому вы можете свободно использовать и распространять ее в вашем приложении.
✔️ SQLite работает на разных платформах и архитектурах.
Подробнее о SQLite см. здесь.
Выбор слоя абстрагирования
Мы рекомендуем использовать Entity Framework Core или библиотеку SQLite с открытым исходным кодом, встроенные корпорацией Майкрософт.
Entity Framework Core
Чтобы испытать ее, см. раздел Начало работы с EF Core.
Библиотеке SQLite
Библиотека Microsoft.Data.Sqlite реализует интерфейсы в пространстве имен System.Data.Common. Майкрософт активно поддерживает эти реализации и предоставляет интуитивно понятную оболочку для низкоуровневых собственных API-интерфейсов SQLite.
В остальных разделах этого руководства приведены инструкции по работе с этой библиотекой.
Настройка решения для использования библиотеки Microsoft.Data.SQlite
Мы начнем с базового проекта UWP, добавим библиотеку классов, а затем установим соответствующие пакеты NuGet.
Тип библиотеки классов, добавляемой в решение, и специальные пакеты, которые вы устанавливаете, зависят от минимальной версии Windows SDK, для которого предназначено ваше приложение. Эти сведения можно найти на странице свойств проекта UWP.
Используйте один из следующих разделов в зависимости от минимальной версии Windows SDK, для которого предназначен вам проект UWP.
Минимальная версия проекта не предназначена для обновления Fall Creators Update
Если вы используете Visual Studio 2015, щелкните Справка->Сведения о Microsoft Visual Studio. Затем в списке установленных программ убедитесь, что версия диспетчера пакетов NuGet — 3.5 или более поздняя версия. Если номер версии ниже, установите более позднюю версию NuGet. Скачать ее можно здесь. На этой странице вы найдете все версии Nuget, перечисленные под заголовком Visual Studio 2015.
Затем добавьте библиотеку классов в свое решение. Использовать библиотеку классов для размещения вашего кода доступа к данным не требуется, но мы используем ее в нашем примере. Мы назовем библиотеку DataAccessLibrary, а класс в библиотеке — DataAccess.
Visual C # > «Универсальная платформа Windows» и выделенным параметром «Библиотека классов».» data-linktype=»relative-path»/>
Щелкните правой кнопкой мыши решение, а затем нажмите кнопку Управление пакетами NuGet для решения.
Если вы используете Visual Studio 2015, выберите вкладку Установленные и убедитесь, что версия пакета Microsoft.NETCore.UniversalWindowsPlatform — 5.2.2 или более поздняя версия.
Если это не так, обновите пакет до более новой версии.
Выберите вкладку Обзор и выполните поиск пакета Microsoft.Data.SQLite. Установите версию пакета 1.1.1 (или ниже).
Минимальная версия проекта предназначена для обновления Fall Creators Update
Существует ряд преимуществ повышения минимальной версии проекта UWP для обновления Fall Creators Update.
Во-вторых, в вашем приложении нет библиотек пакетов SQLite. Вместо этого ваше приложение может использовать версию SQLite, которая поставляется вместе с Windows. Это обеспечивает следующие преимущества.
✔️ Уменьшает размер приложения, поскольку не требуется скачивать двоичную библиотеку SQLite, а затем упаковывать ее в качестве части приложения.
✔️ Отсутствие необходимости в принудительной передаче новой версии вашего приложения пользователям, если SQLite опубликует важные исправления ошибок и уязвимостей безопасности в SQLite. Версия Windows SQLite обслуживается корпорацией Майкрософт совместно с SQLite.org.
✔️ Загрузка приложения может быть быстрее, поскольку, скорее всего, версия SDK-пакета SQLite будет уже загружена в память.
Щелкните правой кнопкой мыши решение, а затем нажмите кнопку Управление пакетами NuGet для решения.
На этом этапе у вас есть выбор. Можно использовать версию SQLite, которая входит в состав Windows, или если по какой-либо причине вы хотите использовать конкретную версию SQLite, можно добавить библиотеку SQLite в пакет.
Давайте начнем с использования версии SQLite, которая входит в состав Windows.
Чтобы использовать версию SQLite, которая устанавливается вместе с Windows, выполните следующие действия.
Выберите вкладку Обзор и выполните поиск пакета Microsoft.Data.SQLite.core, а затем установите его.
Выполните поиск пакета SQLitePCLRaw.bundle_winsqlite3, а затем установите его только в проект UWP в вашем решении.
Добавление SQLite в приложение
Этого делать не требуется. Но если вы хотите добавить конкретную версию SQLite в свое приложение, выберите вкладку Обзор и выполните поиск пакета Microsoft.Data.SQLite. Установите версию пакета 2.0 (или ниже).
Добавление данных в базу данных SQLite и их извлечение
Мы выполним следующие действия.
1️⃣ Подготовка класса доступа к данным.
2️⃣ Инициализация базы данных SQLite.
3️⃣ Вставка данных в базу данных SQLite.
4️⃣ Извлечение данных из базы данных SQLite.
5️⃣ Добавление базового пользовательского интерфейса.
Подготовка класса доступа к данным
В проекте UWP добавьте ссылку на проект DataAccessLibrary в своем решении.
Добавьте следующий оператор using в файлы App.xaml.cs и MainPage.xaml.cs в проекте UWP.
Откройте класс DataAccess в вашем решении DataAccessLibrary и сделайте этот класс статическим.
В нашем примере мы размещаем код доступа к данным в статическом классе, однако это лишь проектное решение, которое не является обязательным.
Добавьте следующие операторы использования в начало этого файла.
Инициализация базы данных SQLite
Добавьте метод в класс DataAccess, который инициализирует базу данных SQLite.
Этот код создает базу данных SQLite и сохраняет ее в локальном хранилище данных приложения.
В конструкторе файла App.xaml.cs проекта UWP вызовите метод InitializeDatabase класса DataAccess.
Вставка данных в базу данных SQLite
Добавьте метод в класс DataAccess, который вставляет данные в базу данных SQLite. Этот код использует параметры в запросе для предотвращения атак путем внедрения кода SQL.
Извлечение данных из базы данных SQLite
Добавьте метод, который возвращает строки данных из базы данных SQLite.
Порядковый номер параметра не так важен в этом примере, так как мы выбираем все записи в одном столбце. Тем не менее, если несколько столбцов являются частью запроса, используйте порядковое значение для получения столбца, из которого требуется извлечь данные.
Добавление базового пользовательского интерфейса
В файл MainPage.xaml проекта UWP добавьте следующий XAML-код.
В файл MainPage.xaml.cs добавьте следующий обработчик. Это метод, который мы связали с кнопкой Click событие Button в пользовательском интерфейсе.
Готово! Изучите Microsoft.Data.Sqlite чтобы узнать, что еще можно сделать с вашей базой данных SQLite. Перейдите по ссылкам ниже, чтобы узнать о других способах использования данных в приложении UWP.
Дальнейшие действия
Подключение приложения непосредственно к базе данных SQL Server
Совместное использование кода между разными приложениями на различных платформах
Добавление страниц с основными и подробными данными с помощью серверов Azure SQL
См. статью Customer Orders Database sample (Пример базы данных заказов клиентов).
SQLite + C#
В данной статье рассмотрим работу с SQLite из программы на языке C#. Основное внимание будет уделено конфигурированию проекта в MS Visual Studio для работы с SQLite, созданию базы данных, созданию таблиц и работе с таблицами: чтение/запись данных.
Исходный код доступен на GitHub.
Введение в SQLite
Если кратко, то SQLite – это кроссплатформенная встраиваемая СУБД. Свойство кроссплатформенности я думаю пояснять не нужно, а вот с понятием “встраиваемая” наверное стоит немного разобраться. Существуют СУБД, которые представляют собой клиент-серверное приложение – это наиболее знакомый вариант. Например Microsoft SQL Server, MySQL, PostgreSQL, различные NoSQL варианты, которых на сегодняшний день появилось огромное количество. Суть их в том, что есть выделенное приложение – сервер, которое принимает запросы от клиентов и выполняет их, оно непосредственно занимается записью/чтением данных на диск и предоставляет различные функции типа репликации и т.п. Встраиваемая СУБД не имеет выделенного сервера, ее движок включается в приложение в виде библиотеки и предоставляет доступ к базе через специализированный API.
На сегодняшний день SQLite является одной из самых популярных решений такого типа. Она используется практически повсеместно: в embedded приложениях, мобильных телефонах, различных платформах и т.д. Например браузер Google Chrome использует SQLite для хранения Cookies. SQLite обладает феноменальной надежностью (зачастую в ущерб производительности, если её неправильно “готовить”), поэтому, несмотря на то, что она является открытой, разработчики практически не принимают сообщения об ошибках.
Сами разработчики рекомендуют брать во внимание следующие моменты при выборе дистрибутива SQLite:
Структура папки, в которой располагается приложение, для поддержки режима автоматической подгрузки нужных библиотек (Native Library Pre-Loading) представлена ниже
Работа с SQLite из C#
Создадим простое приложение, демонстрирующее работу с SQLite СУБД. В качестве среды разработки будем использовать Visual Studio 2015 Community Edition.
Подготовка
Первое, что мы сделаем, это скачаем с официального сайта пакеты Precompiled Binaries for 64-bit Windows (.NET Framework 4.0) и Precompiled Binaries for 32-bit Windows (.NET Framework 4.0). На момент написания статьи это была версия sqlite-netFx40-binary-x64-2010-1.0.101.0.zip и sqlite-netFx40-binary-Win32-2010-1.0.101.0.zip
В Visual Studio создадим проект Windows Forms Application с именем SQLiteSample.
После этого необходимо собрать проект, для того, чтобы IDE создала необходимый набор каталогов. В нашем случае интерес представляет \bin\Debug. В него добавим необходимый набор файлов, как показано выше в описании структуры папок при использовании подхода Native Library Pre-Loading.
Добавим в проект ссылку на библиотеку System.Data.SQLite.dll, предварительно скопировав ее в папку SQLiteSample\SQLiteSample\lib. Для этого на панели меню выбрать Project/Add Reference… В открывшемся окне нажать кнопку Browse… и выбрать файл System.Data.SQLite.dll. Что привет к появлению нового Reference в окне Solution Explorer.
Приложение будет представлять собой форму для работы с базой данных, содержащей имена писателей и названия их произведений. Внешний вид представлен на рисунке ниже.
На панели инструментов имеются несколько кнопок:
В строке состояния отображается статус:
Создание базы данных, таблиц и работа с данными
Сейчас более подробно рассмотрим процессы создания базы данных, таблиц и работы с записями таблицы (чтение и добавление). Каждая из этих задач будет решаться в рамках метода, вызываемого при нажатии на соответствующую кнопку.
Предварительно подключим в нашем проекте пространство имен System.Data.SQLite и добавим переменные для связи с базой данных. Таким образом наша программа будет иметь вид.
Создание БД и таблицы
Создание БД и таблицы в “SQLite Sample”, если они ещё не созданы, осуществляется при нажатии на кнопку Create.
В данном методе, мы сначала проверяем, существует ли файл с именем “sample.sqlite” (переменная dbFileName), если его нет, то создаем. Этот файл фактически и является базой данных.
После этого мы подключаемся к созданной БД:
Для выполнения SQL команд будем использовать переменную m_sqlCmd, чтобы это стало возможным в первую очередь зададим объект класса SqlConnection, используемый SQLiteCommand:
После выполним запрос на создание таблицы:
Подключение к уже существующей таблице
Подключение к уже существующей таблице осуществляется при нажатии на кнопку Connect. Код метода очень похож на тот, что мы разбирали выше, поэтому на нем мы останавливаться не будем.
Чтение данных
Чтение данных осуществляется при нажатии на кнопку Read all, при этом из существующей БД считываются все данные и выводятся в таблицу.
Разберем этот метод более подробно. Первое, что необходимо сделать, это проверить наличие связи с БД:
Данные, считанные из базы, мы будем помещать в таблицу DataTable, а из неё будем из перегружать в элемент DataGridView, расположенный на нашей форме. Для этого создадим SQL запрос и адаптер, который будет выполнять запрос и передавать полученные от СУБД данные в таблицу
Если таблица не пуста, перенесем данные из нее в элемент dgvViewer.
Добавление данных в БД
Добавление данных в БД осуществляется при нажатии на кнопку Add. При этом будет вызван соответствующий метод.
В нем мы также, вначале проверяем, есть ли связь с БД, после этого создает диалоговое окно для ввода имени автора и названия произведения.
Если окно было закрыто по кнопку OK, то записываем введенные данные в БД
На этом можно завершить описание базовых понятий и методов работы с СУБД SQLite.
Спасибо за внимание!
SQLite + C# : 13 комментариев
Например Microsoft SQL Server, MySQL, PostgreSQL, различные NoSQL варианты, который на сегодняшний день появилось огромное количество.
которых – поправьте, пожалуйста
Привет, у тебя нет проблем с поиском кириллических символов в базе? У меня почему-то совсем не ищет
Добрый день! Нет, с такой проблемой не сталкивался. Попробую посмотреть, если что-то найду интересное – напишу.
Здравствуйте. У меня компилятор ругается на то, что не находит пространство имен для AddDataToDb…Что делать?
Вы скачали проект с GitHub(https://github.com/devpractice-repo/SQLiteAndCSharp)? Если да, то должно быть все нормально, если собираете сами, то вам нужно создать соответствующую форму.
P.S.
Лучше возьми пример с GitHub)))
Если что-то не будет работать, отправляйте свой проект на devpractice.mail@gmail.com мы посмотрим.
Здравствуйте. Вот такая ошибка выскакивает при запуске проекта https://i.imgur.com/mPPCeHi.png
Что я делаю не так?
Просто скачал проект с гитхаба и пробую запустить.
Добрый день!
Проверьте, что у вас скачены и установлены все необходимые файлы для работы с SQLite, для этого прочитайте ещё раз раздел (Введение в SQLite) и (Работа с SQLite из C# / Подготовка). Подсказка: в папке bin/Debug у вас должен быть следующий набор файлов:
SQLiteSample.exe
SQLiteSample.exe.config
SQLiteSample.pdb
System.Data.SQLite.dll
System.Data.SQLite.EF6.dll
System.Data.SQLite.Linq.dll
x64/SQLite.Interop.dll
x86/SQLite.Interop.dll
Файлы SQLite.Interop.dll нужно взять вот отсюда http://system.data.sqlite.org/downloads/1.0.109.0/sqlite-netFx40-binary-x64-2010-1.0.109.0.zip и от сюда http://system.data.sqlite.org/downloads/1.0.109.0/sqlite-netFx40-binary-Win32-2010-1.0.109.0.zip
Нужно установить Microsoft Visual C++ 2010
Не ясно как определить lbStatusText.Text. Явно в проекте lbStatusText.Text не определена, а других пояснений нет.
Вот скажите человек пытается разобраться БД, а вы еще ему тему со StatusStrip подбрасываете. В вашем примере lbStatusText.Text не определена. Нужно лезть подключать StatusStrip. А это совсем другая опера. Нельзя ли сделать этот пример без StatusStrip?
Полезная статья, однако, не раскрыта тема команды Update. Т.е изменение данных в таблице формы, и перенос этих изменений в базу.
Здравствуйте.
Подскажите пожалуйста, как мне прочитать данные из ячейки, находящейся в определённом столбце?
К примеру, есть таблица из 4 столбцов: title, discription, date, sirial
Допустим мне нужно прочитать данные из 6-ой строки столбца description
Скажите пожалуйста, как правильно сформировать запрос к базе и вывести результат например в MessageBox?
Большое спасибо
Работа с SQLite в C# (.NET 5)
С SQLite более менее детально я знакомился ещё при работе в Delphi. И, думаю, что не стоит сильно углубляться в рассмотрение всех преимуществ этой компактной встраиваемой СУБД. В этой статье я постараюсь рассмотреть основные моменты работы с SQLite в C# (.NET 5), которые позволят нам, в дальнейшем, более детально разобраться с использованием СУБД SQLite в своих проектах на C#. Для того, чтобы не отвлекаться на моменты работы с графическим интерфейсом, напишем небольшую консольную программку, использующую SQLite.
После того, как Visual Studio создаст новый проект, необходимо зайти в свойства проекта и выбрать платформу .NET 5:
Установка необходимых пакетов
Для того, чтобы иметь возможность работать с БД SQLite в C# нам потребуется пакет System.Data.SQLite. Чтобы его установить, достаточно воспользоваться менеджером пакетов NuGet. Выбираем в контекстном меню проекта «Управление пакетами NuGet…»
в строке поиска набираем «SQLite» и ищем пакет System.Data.SQLite.
После нажатия кнопки «Установить» Visual Studio внесет изменения в решение и установит также дополнительные пакеты:
После окончательной установки всех необходимых пакетов, вид вашего проекта в обозревателе решений должен быть вот таким:
Теперь можно начинать работу с SQLite в C# (.NET 5).
Подключение к БД SQLite в C#
Добавим в наш проект пространство имен System.Data.SQLite и напишем следующий метод подключения к базе данных:
Создание таблиц БД SQLite в C#
Создадим новую таблицу в наше базе данных. Для этого, допишем код метода Main() следующим образом:
Запись данных в БД SQLite в C#
Добавление записей в SQLite
Добавим одну запись в таблицу базы данных SQLite, используя все тот же объект типа SQLiteCommand :
В приведенном выше примере мы использовали в качестве запроса обычную строку с заранее известными параметрами запроса. Однако, удобнее использовать для добавления новых записей в БД SQLite запрос с параметрами. Сделать это можно, например, следующим образом:
Использование транзакций SQLite
Одной из претензий, которую предъявляли (и, иногда, продолжают предъявлять) новички в работе с SQLite к этой замечательной базе данных является то, что, по мнению новичков, запись в эту базу данных происходит очень медленно. Действительно, посмотрим на вот такой код:
Здесь мы пробуем записать в базу SQLite 1000 записей и, при этом, засекаем время выполнения операции. Вот, что покажет нам счётчик времени выполнения операции:
Тринадцать секунд на добавление 1000 записей в базу данных — это достаточно много. Ускорить время выполнения операции добавления записей SQLite на порядок позволяет использование транзакций. Перепишем наш код следующим образом:
и посмотрим, что покажет счётчик времени выполнения операции:
Как видите, выполнение транзакции в SQLite позволило сократить время выполнения операции более, чем на 99%.
Чтение данных из БД SQLite в C#
Для того, чтобы понять как происходит чтение данных из таблиц БД SQLite в C# мы можем воспользоваться следующим простым примером:
Объект типа DataTable представляет собой таблицу данных в памяти. В этой таблице (как и в любой другой таблице) все данные хранятся в виде столбцов и строк, где каждая строка — это отдельная запись таблицы БД. В свою очередь объект типа SQLiteDataAdapter предоставляет нам набор команд и методов для работы с наборами данных.
ИТОГО
Сегодня мы научились выполнять основные операции для работы с базой данный SQLite: создавать соединение с базой данных, создавать новые таблицы, заполнять таблицы данными и считывать данные из таблиц баз данных SQLite. Для того, чтобы запись данных происходила быстрее, мы использовали транзакции, которые позволили ускорить запись в таблицу SQLite более чем на 99%.