Поделиться через

Построение приложений для настольных компьютеров (SQL Server Compact)

  • Статья

SQL Server Compact 3.5 может использоваться в качестве хранилища данных для приложений компьютера. В этом разделе описано, как добавить SQL Server Compact 3.5 в среду Visual Studio и работать с пространством имен System.Data.SqlServerCe. Управляемые справочные разделы по пространству имен System.Data.SqlServerCe см. в в справочной документации по .NET Framework.

Создание проекта для компьютера

Чтобы создать новое приложение для компьютера, необходимо сначала создать в среде Visual Studio проект Windows. Чтобы получить приложение для компьютера, необходимо добавить ссылку на пространство имен Microsoft.Ink.

Примечание

Если приложение для Tablet PC разрабатывается не на компьютере, где установлен выпуск Windows XP Tablet PC Edition, необходимо сначала установить пакет Microsoft Windows XP Tablet PC Edition Development Kit. Последнюю версию пакета можно загрузить в центре для разработчиков встроенных приложений и приложений для мобильных устройств.

Создание нового проекта для компьютера

  1. В среде Visual Studio укажите в меню Файл команду Создать, а затем выберите команду Проект.

  2. В списке Установленные шаблоны в диалоговом окне Новый проект разверните узел языка программирования, который будет использоваться, и выберите пункт Windows.

  3. В списке Шаблоны выберите пункт Приложение Windows Forms.

  4. Укажите имя и расположение проекта, затем нажмите кнопку ОК.

    В Visual Studio будет создан новый проект, а на экране появится основная форма (Form1).

  5. В обозревателе решений щелкните правой кнопкой мыши папку Ссылки и выберите команду Добавить ссылку (не обязательно).

    Примечание

    Если папка Ссылки не отображается в обозревателе решений, нажмите кнопку Показать все файлы на панели инструментов в верхней части обозревателя решений.

  6. (Дополнительно) В списке сборок .NET выберите Microsoft Tablet PC API и нажмите кнопку ОК.

    В список ссылок будет включен пункт Microsoft.Ink.

Добавление SQL Server Compact 3.5 в проект при построении для центрального развертывания

После создания проекта необходимо добавить в него ссылку на сборку SQL Server Compact 3.5. Процедуры добавления ссылок на сборки SQL Server Compact 3.5 при построении приложений для отдельного и для центрального развертывания SQL Server Compact 3.5 немного различаются. Для центрального развертывания выполните следующие действия.

Добавление ссылки на SQL Server Compact 3.5 для центрального развертывания

  1. В обозревателе решений щелкните правой кнопкой мыши папку Ссылки и выберите команду Добавить ссылку.

    Примечание

    Если папка Ссылки не отображается в обозревателе решений, нажмите кнопку Показать все файлы на панели инструментов в верхней части обозревателя решений.

  2. В списке сборок .NET выберите System.Data.SqlServerCe и нажмите кнопку ОК. Если System.Data.SqlServerCe отсутствует в списке, выполните следующие действия.

    1. В диалоговом окне Добавление ссылок нажмите кнопку Обзор.

    2. Перейдите в папку установки: %Program Files%\Microsoft SQL Server Compact Edition\v3.5\Desktop.

    3. Выберите файл System.Data.SqlServerCe.dll и нажмите кнопку ОК.

    В список ссылок обозревателя решений будет включен пункт System.Data.SqlServerCe, а в проекте можно будет использовать эту сборку.

    Примечание

    Если в проекте используется Entity Framework, повторите те же шаги, чтобы добавить ссылку на System.Data.SqlServerCe.Entity. Можно добавить System.Data.SqlServerCe.Entity из списка сборок .NET либо выбрать ее в папке %Program Files%\Microsoft SQL Server Compact Edition\v3.5.

  3. В обозревателе решений щелкните правой кнопкой мыши Form1.cs или Form1.vb, затем выберите команду Просмотреть код.

  4. В верхней части кода формы добавьте директиву использовать пространство имен System.Data.SqlServerCe. Если используется Entity Framework, добавьте директиву для использования пространства имен System.Data.SqlServerCe. Если это приложение для Tablet PC, добавьте также директиву использовать API для Tablet PC:

    • C#

      using System.Data.SqlServerCe;
using System.Data.SqlServerCe.Entity; 
using Microsoft.Ink;

    • Visual Basic

      Imports System.Data.SqlServerCe
Imports System.Data.SqlServerCe.Entity
Imports Microsoft.Ink

Добавление SQL Server Compact 3.5 в проект при построении для отдельного развертывания

После создания проекта необходимо добавить в него ссылку на сборку SQL Server Compact 3.5. Процедуры добавления ссылок на сборки SQL Server Compact 3.5 при построении приложений для отдельного и для центрального развертывания SQL Server Compact 3.5 немного различаются. Для отдельного развертывания выполните следующие действия.

Добавление ссылки на SQL Server Compact 3.5 для центрального развертывания

  1. В обозревателе решений щелкните правой кнопкой мыши папку Ссылки и выберите команду Добавить ссылку.

    Примечание

    Если папка Ссылки не отображается в обозревателе решений, нажмите кнопку Показать все файлы на панели инструментов в верхней части обозревателя решений.

  2. В диалоговом окне Добавление ссылок нажмите кнопку Обзор.

  3. Перейдите в папку %Program Files%\Microsoft SQL Server Compact Edition\v3.5\Private.

  4. Выберите System.Data.SqlServerCe и нажмите кнопку ОК.

    В список ссылок обозревателя решений будет включен пункт System.Data.SqlServerCe, а в проекте можно будет использовать эту сборку.

    Примечание

    Если в проекте используется Entity Framework, повторите те же шаги, чтобы добавить ссылку на System.Data.SqlServerCe.Entity. (Для отдельного развертывания System.Data.SqlServerCe.Entity также добавляется из папки %Program Files%\Microsoft SQL Server Compact Edition\v3.5\Private.)

  5. В обозревателе решений щелкните правой кнопкой мыши Form1.cs или Form1.vb, затем выберите команду Просмотреть код.

  6. В верхней части кода формы добавьте директиву использовать пространство имен System.Data.SqlServerCe. Если используется Entity Framework, добавьте директиву для использования пространства имен System.Data.SqlServerCe. Если это приложение для Tablet PC, добавьте также директиву использовать API для Tablet PC:

    • C#

      using System.Data.SqlServerCe;
using System.Data.SqlServerCe.Entity; 
using Microsoft.Ink;

    • Visual Basic

      Imports System.Data.SqlServerCe
Imports System.Data.SqlServerCe.Entity
Imports Microsoft.Ink

Настройка SQL Server Compact для отдельного развертывания

При построении приложения, использующего отдельное развертывание SQL Server Compact 3.5, нужно убедиться, что поставщик .NET Framework и все необходимые собственные DLL-библиотеки развернуты в выходном каталоге приложения. Чтобы приложение использовало отдельное развертывание SQL Server Compact 3.5, следуйте шагам, описанным в этом разделе. Если приложение не использует отдельное развертывание, можете его пропустить. Дополнительные сведения об отдельном развертывании SQL Server Compact 3.5 см. в разделе Сравнение отдельного развертывания с центральным развертыванием (SQL Server Compact). Выполнение следующих шагов предполагает, что приложение будет рассчитано на любую целевую платформу (32-разрядную и 64-разрядную). Если приложение рассчитано только на одну из этих платформ, можно пропустить шаги, относящиеся к другой из них.

Настройка приложения для отдельного развертывания SQL Server Compact

  1. Настройте копирование сборки поставщика данных .NET Framework для SQL Server Compact 3.5 в выходной каталог при построении проекта.

    1. В обозревателе решений раскройте узел Ссылки, щелкните правой кнопкой мыши System.Data.SqlServerCe и выберите Свойства.

    2. Для System.Data.SqlServerCe в окне Свойства ссылки установите Копировать локально в значение True.

    Примечание

    Если в проекте используется Entity Framework, повторите те же шаги для System.Data.SqlServerCe.Entity, чтобы настроить копирование поставщика данных Entity Framework для SQL Server Compact 3.5 в выходной каталог.

  2. Добавьте в проект все необходимые 32-разрядные собственные библиотеки SQL Server Compact 3.5.

    1. В обозревателе решений щелкните проект правой кнопкой мыши, укажите Добавить и выберите Новую папку. Назовите папку x86.

    2. В обозревателе решений щелкните папку x86 правой кнопкой мыши, укажите Добавить и выберите Существующий элемент.

    3. В диалоговом окне Добавление существующего элемента перейдите в папку, в которой находятся 32-разрядные собственные библиотеки. В 32-разрядной версии Windows это папка %Program Files%\Microsoft SQL Server Compact Edition\v3.5. В 64-разрядной версии Windows это папка %Program Files (x86)%\Microsoft SQL Server Compact Edition\v3.5.

    4. Щелкните все необходимые проекту собственные библиотеки, удерживая нажатой клавишу CTRL, чтобы выбрать их в списке, а затем нажмите кнопку ОК. Библиотеки будут добавлены в папку x86.

      Примечание

      Как минимум должны быть добавлены следующие библиотеки: sqlceme35.dll, sqlceqp35.dll, sqlcese35.dll и sqlceer35.dll.

  3. Добавьте в проект все необходимые 64-разрядные собственные библиотеки SQL Server Compact 3.5.

    1. В обозревателе решений щелкните проект правой кнопкой мыши, укажите Добавить и выберите Новую папку. Назовите папку x64.

    2. В обозревателе решений щелкните папку x64 правой кнопкой мыши, укажите Добавить и выберите Существующий элемент.

    3. В диалоговом окне Добавление существующего элемента перейдите в папку, в которой находятся 64-разрядные собственные библиотеки. В 64-разрядной версии Windows это папка %Program Files%\Microsoft SQL Server Compact Edition\v3.5.

      Примечание

      Нельзя установить 64-разрядную версию SQL Server Compact 3.5 на компьютере с 32-разрядной версией Windows. Чтобы добавить 64-разрядные собственные библиотеки в 32-разрядной среде разработки, необходимо сначала извлечь эти файлы из 64-разрядного установщика в каталог на компьютере разработчика. Затем можно перейти в этот каталог и добавить в проект 64-разрядные собственные библиотеки. Дополнительные сведения о том, как извлечь файлы из установщика, см. в разделе Как извлечь 64-разрядные DLL-библиотеки из установщика среды выполнения SQL Server Compact.

    4. Щелкните все необходимые проекту собственные библиотеки, удерживая нажатой клавишу CTRL, чтобы выбрать их в списке, а затем нажмите кнопку ОК. Библиотеки будут добавлены в папку x64.

      Примечание

      Как минимум должны быть добавлены следующие библиотеки: sqlceme35.dll, sqlceqp35.dll, sqlcese35.dll и sqlceer35.dll.

  4. Настройте копирование всех собственных библиотек, добавленных на предыдущих шагах, в выходной каталог при построении проекта. Это нужно сделать для всех библиотек в обоих каталогах.

    1. В обозревателе решений щелкните правой кнопкой мыши библиотеку (например, sqlcese35.dll) и выберите ее свойства.

      Примечание

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

    2. В окне Свойства для файла выберите пункт Копировать всегда или Копировать более новые в раскрывающемся списке Копировать в выходной каталог.

  5. Настройте для построения проекта Любой ЦП.

    1. В обозревателе решений щелкните проект правой кнопкой мыши и выберите Свойства, чтобы открыть конструктор проекта.

    2. Нажмите Построить и выберите пункт Любой ЦП в раскрывающемся списке Целевая платформа.

Использование объектов SQL Server Compact 3.5

После добавления пространства имен System.Data.SqlServerCe можно приступить к составлению кода с помощью объектов SQL Server Compact 3.5. В следующем примере кода показан способ использования объекта Engine для создания нового файла базы данных SQL Server Compact 3.5.

using System;
using System.Data.SqlServerCe;
using System.IO;

public class MySqlCeEngine
{
    public void CreateDB()
    {
        File.Delete("Test.sdf");
        string connString = "Data Source='Test.sdf'; LCID=1033;   Password=<enterStrongPasswordHere>; Encrypt = TRUE;";
        SqlCeEngine engine = new SqlCeEngine(connString);
        engine.CreateDatabase();
    }
}

Imports System
Imports System.Data.SqlServerCe
Imports System.IO

Public Class MySqlCeEngine

    Public Sub CreateDB()
        File.Delete("Test.sdf")
        Dim connString As String = "Data Source='Test.sdf'; LCID=1033; Password=<enterStrongPasswordHere>; Encrypt = TRUE;"
        Dim engine As New SqlCeEngine(connString)
        engine.CreateDatabase()
    End Sub
End Class

См. также

Справочник

Пространство имен System.Data.SqlServerCe (справочная документация по .NET Framework)