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)..