ISSCEEngine.UpgradeDatabase (SQL Server Compact)

Метод ISSCEEngine.Upgrade обновляет базу данных SQL Server Compact 3.5 с версии 3.1 до версии 3.5. Если исходная база данных зашифрована, то обновленная база данных также будет зашифрована. Обновленная база данных не будет зашифрована, если в целевой строке пароль не указан явно.

Синтаксис

object.UpgradeDatabase(SourceConnection, DestConnection)

Параметры

Параметр

Описание

SourceConnection

Строковое значение, определяющее соединение с исходной базой данных (обновляемой). Если база данных, указанная в строке SourceConnection, уже открыта, то возникнет ошибка.

DestConnection (необязательный)

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

Если параметр DestConnection равен null, то LCID, Password и другие необязательные свойства будут унаследованы от исходного файла.

Возвращаемое значение

Возвращается значение типа HRESULT, которое в случае успеха равно S_OK.

Прототип

HRESULT UpgradeDatabase(BSTR SourceConnection, BSTR DestConnection);

Чтобы обновить базу данных SQL Server Compact 3.5 с версии 3.1 до версии 3.5, не создавая новый файл, укажите в строках соединения для исходной и целевой баз данных один и тот же источник данных.

Замечания

Параметры SourceConnection и DestConnection задают свойства исходной и целевой баз данных. В таблице перечислены свойства соединения, которые можно указать для каждого параметра. Все остальные свойства соединения не учитываются.

Свойство

Описание

Data Source

Имя базы данных. Это свойство является обязательным для строк соединения и с исходной, и с целевой базой данных.

Locale Identifier

Служит для указания идентификатора языка и стандартов (LCID) для новой базы данных. Если не указан, то целевая база данных будет иметь LCID, идентичный системному языковому стандарту.

Код языка задает порядок сортировки при сравнении строк в базе данных.

SSCE:Database Password

Служит для указания пароля, если база данных имеет парольную защиту. Если исходная база данных защищена паролем, то этот пароль следует указать. Если этот параметр в строке DestConnection не указан, то новая база данных будет защищена тем же паролем, что и исходная. Если необходимо удалить защиту целевой базы данных паролем, то в качестве пароля необходимо указать пустую строку. Длина пароля не может превышать 40 символов.

SSCE:Temp File Directory

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

SSCE:Encryption Mode

Указывает целевой режим шифрования. Если этот параметр не указан, используется Platform Default.

SSCE:Case Sensitive

Определяет, учитывается ли регистр в параметрах сортировки базы данных. При значении true учет регистра включен, при значении false — отключен. Если значение не указано, по умолчанию используется значение false.

ПримечаниеПримечание
Это свойство соединения было введено в версии SQL Server Compact 3.5.

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

Перечень других допустимых режимов шифрования см. в разделе Обновление с предыдущих версий (SQL Server Compact).