Класс SqlCeEngine

  • Статья

Представляет свойства, методы и другие объекты компонента SQL Server Compact Engine. Этот класс не может быть унаследован.

Иерархия наследования

System.Object
  System.Data.SqlServerCe.SqlCeEngine

Пространство имен:  System.Data.SqlServerCe
Сборка:  System.Data.SqlServerCe (в System.Data.SqlServerCe.dll)

Синтаксис

'Декларация
Public NotInheritable Class SqlCeEngine _
    Implements IDisposable
'Применение
Dim instance As SqlCeEngine

public sealed class SqlCeEngine : IDisposable

public ref class SqlCeEngine sealed : IDisposable

[<SealedAttribute>]
type SqlCeEngine =  
    class
        interface IDisposable
    end

public final class SqlCeEngine implements IDisposable

Тип SqlCeEngine обеспечивает доступ к следующим элементам.

Конструкторы

  Имя Описание
Открытый метод SqlCeEngine() Инициализация нового экземпляра класса SqlCeEngine.
Открытый метод SqlCeEngine(String) Инициализация нового экземпляра класса SqlCeEngine с указанной строкой подключения к локальной базе данных.

В начало

Свойства

  Имя Описание
Открытое свойство LocalConnectionString Возвращает или устанавливает строку подключения с базой данных SQL Server Compact.

В начало

Методы

  Имя Описание
Открытый метод Compact Освобождает место на диске, занимаемое базой данных SQL Server Compact, создавая новый файл базы данных на основе уже существующего. Этот метод также используется для изменения порядка сортировки, параметров шифрования или параметров пароля для базы данных.
Открытый метод CreateDatabase Создает новую базу данных.
Открытый метод Dispose Освобождает все ресурсы компонента SQL Server Compact SqlCeEngine.
Открытый метод Equals (унаследовано из Object)
Защищенный метод Finalize (унаследовано из Object)
Открытый метод GetHashCode (унаследовано из Object)
Открытый метод GetType (унаследовано из Object)
Защищенный метод MemberwiseClone (унаследовано из Object)
Открытый метод Repair Восстанавливает поврежденную базу данных.
Открытый метод Shrink Освобождает место на диске, занимаемое базой данных SQL Server Compact, перемещая пустые страницы в конец файла, а затем производя его усечение.
Открытый метод ToString (унаследовано из Object)
Открытый метод Upgrade() Обновление базы данных SQL Server Compact версии 3.5 до 4.0. Если база данных-источник была зашифрована, то после обновления она также будет зашифрована, в противном случае шифрование базы данных производиться не будет.
Открытый метод Upgrade(String) Обновление базы данных SQL Server Compact версии 3.5 до 4.0. Целевая база данных будет зашифрована, если в целевой строке соединения с назначением был указан режим шифрования. В параметрах сортировки базы данных будет учитываться регистр, если в строке подключения свойство «Case Sensitive» имеет значение true.
Открытый метод Verify() Повторно вычисляет для каждой страницы в базе данных контрольные суммы и сравнивает их с ожидаемыми значениями.
Открытый метод Verify(VerifyOption) Проверяет целостность базы данных на основании параметра VerifyOption.

В начало

Замечания

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

SQL Server Compact можно использовать для разработки веб-приложений ASP.NET. В предыдущих версиях SQL Server Compact для использования SQL Server Compact в веб-приложениях ASP.NET требовалось устанавливать флаг SQLServerCompactEditionUnderWebHosting. В SQL Server Compact 4.0. этот флаг удален.

Примеры

На следующем образце показано, как создать новую базу данных SQL Server Compact.

If File.Exists("Test.sdf") Then
   File.Delete("Test.sdf")
End If 
Dim connStr As String = "Data Source = Test.sdf; Password = <password>"

Dim engine As New SqlCeEngine(connStr)
engine.CreateDatabase()
engine.Dispose()

Dim conn As SqlCeConnection = Nothing

Try
   conn = New SqlCeConnection(connStr)
   conn.Open()

   Dim cmd As SqlCeCommand = conn.CreateCommand()
   cmd.CommandText = "CREATE TABLE myTable (col1 int, col2 ntext)"
   cmd.ExecuteNonQuery()
Catch
Finally
   conn.Close()
End Try

if (File.Exists("Test.sdf"))
    File.Delete("Test.sdf");

string connStr = "Data Source = Test.sdf; Password = <password>";

SqlCeEngine engine = new SqlCeEngine(connStr);
engine.CreateDatabase();
engine.Dispose();

SqlCeConnection conn = null;

try {
    conn = new SqlCeConnection(connStr);
    conn.Open();

    SqlCeCommand cmd = conn.CreateCommand();
    cmd.CommandText = "CREATE TABLE myTable (col1 int, col2 ntext)";
    cmd.ExecuteNonQuery();
}
catch {}
finally {
    conn.Close();
}

Безопасность многопоточности

Все общие статические члены (Shared в Microsoft Visual Basic) этого типа можно использовать в потокобезопасных операциях. Потокобезопасная работа с членами экземпляров типа не гарантируется.

См. также

Справочник

Пространство имен System.Data.SqlServerCe