Метод CompactDatabase (SQL Server Compact Edition)
Метод CompactDatabase служит для высвобождения неиспользуемого места в локальной базе данных SQL Server 2005 Compact Edition (SQL Server Compact Edition). Этот метод может также использоваться для изменения порядка сопоставления, параметров шифрования и пароля базы данных.
Синтаксис
object.CompactDatabase(SourceConnection, DestConnection)
Параметры
| Параметр | Описание |
|---|---|
SourceConnection |
Строковое значение, задающее соединение с исходной базой данных, которую требуется сжать. Если база данных, указанная в строке SourceConnection, уже открыта, возникает ошибка |
DestConnection |
Строковое значение, задающее соединение с конечной базой данных, которая создается при сжатии. Если база данных, указанная в строке DestConnection, уже существует либо существует файл с тем же именем, возникает ошибка |
Прототип
HRESULT CompactDatabase(BSTR SourceConnection, BSTR DestConnection);
Замечания
Параметры SourceConnection и DestConnection задают свойства исходной и конечной баз данных. В таблице перечислены свойства соединения, которые можно указать для каждого параметра. Все остальные свойства соединения игнорируются.
| Свойство | Описание | ||
|---|---|---|---|
Provider |
Служит для указания имени поставщика, с помощью которого устанавливается соединение с источником данных. Если свойство не задано, используется поставщик OLE DB для SQL Server Compact Edition. Если в исходной и конечной строках заданы разные имена поставщиков, возникает ошибка |
||
Data Source |
Служит для указания имени базы данных. Это свойство является обязательным для сведений о соединении с исходной и конечной базой данных. |
||
Locale Identifier |
Служит для указания идентификатора языка и стандартов (LCID) для новой базы данных. Если он не задан, у конечной базы данных будет тот же LCID, что и у исходной. Свойство Locale Identifier задает порядок сопоставления для сравнения строк в базе данных |
||
SSCE:Database Password |
Служит для указания пароля, если база данных имеет парольную защиту. Если исходная база данных защищена паролем, то этот пароль следует указать. Если этот параметр пропущен в строке DestConnection , то у новой базы данных будет тот же пароль, что и у исходной. Если необходимо снять парольную защиту с конечной базы данных, то в качестве пароля задается пустая строка. Длина пароля базы данных — до 40 знаков |
||
SSCE:Encrypt Database |
Служит для указания, следует ли шифровать базу данных. Если этот параметр пропущен в строке DestConnection , то у новой базы данных будет такое же шифрование, что и у исходной. Это логическое значение; TRUE включает шифрование, FALSE — отменяет
|
||
SSCE:Temp File Directory |
Служит для указания расположения временной базы данных. Если этот параметр пропущен в строке DestConnection , то расположение текущей базы данных используется для размещения временной базы данных. |
.gif)
Примечание.Значения идентификатора языка и стандартов поддерживаются. В качестве значения Locale Identifier следует использовать уникальный код LCID. Список уникальных значений LCID см. в разделе COLLATE (SQL Server Compact Edition). Необходимо, чтобы язык и стандарты поддерживались на устройстве, на котором создается база данных.
Если при создании базы данных код LCID не указан, то SQL Server Compact Edition использует язык системы. В этом состоит отличие от предыдущих версий, в которых в таких случаях всегда использовался английский язык.
См. также
Справочник
Свойство ErrorRecords (SQL Server Compact Edition)
Другие ресурсы
Программирование с помощью объекта ядра СУБД SQL Server Compact Edition