SqlCeEngine.Compact Method

Статья
01/14/2011

Освобождает место на диске, занимаемое базой данных SQL Server Compact 3.5, создавая новый файл базы данных на основе уже существующего. Этот метод также используется для изменения порядка сортировки, параметров шифрования или параметров пароля для базы данных.

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

Синтаксис

'Декларация
Public Sub Compact ( _
    connectionString As String _
)

public void Compact (
    string connectionString
)

public:
void Compact (
    String^ connectionString
)

public void Compact (
    String connectionString
)

public function Compact (
    connectionString : String
)

Параметры

connectionString
Строка соединения с целевой базой данных.

Замечания

Строка соединения описывает соединение с целевой базой данных, которое будет создано этим методом.

Если указанная база данных или другой файл с таким же именем уже существуют, то возникнет исключение. .

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

Важно!

После непредвиденного завершения приложения перед завершением операции Compact в системе остается файл временной базы данных. Этот файл имеет имя <имя_файла>pack.sdf, и его необходимо удалить вручную.

Пример

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

Dim engine As New SqlCeEngine("Data Source = AdventureWorks.sdf")

' Specify null destination connection string for in-place compaction
'
engine.Compact(Nothing)

' Specify connection string for new database options; The following 
' tokens are valid:
'      - Password
'      - LCID
'      - Encrypt
' 
' All other SqlCeConnection.ConnectionString tokens are ignored
'
engine.Compact("Data Source=; Password =a@3!7f$dQ;")

SqlCeEngine engine = new SqlCeEngine("Data Source = AdventureWorks.sdf");

// Specify null destination connection string for in-place compaction
//
engine.Compact(null);

// Specify connection string for new database options; The following 
// tokens are valid:
//      - Password
//      - LCID
//      - Encrypt
// 
// All other SqlCeConnection.ConnectionString tokens are ignored
//
engine.Compact("Data Source=; Password =a@3!7f$dQ;");

Многопоточное использование

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

Платформы

Платформы разработки

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Сведения о версии
.NET Framework и NET Compact Framework
Поддерживается в версии 3.5
.NET Framework
Поддерживается в версии 3.0
.NET Compact Framework и .Net Framework
Поддерживается в версии 2.0

См. также

Справочник

SqlCeEngine Class
SqlCeEngine Members
System.Data.SqlServerCe Namespace

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