ISSCEEngine.UpgradeDatabase (SQL Server Compact)

Статья
05/27/2011

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

Синтаксис

object.UpgradeDatabase(SourceConnection, DestConnection)

Параметры

Параметр	Описание
SourceConnection	Строковое значение, определяющее соединение с исходной базой данных (обновляемой). Если база данных, указанная в строке SourceConnection, уже открыта, то возникнет ошибка.
DestConnection (необязательный)	Строковое значение, определяющее соединение с целевой базой данных, если существует другой файл с таким же именем. Если параметр DestConnection равен NULL, то LCID, Password и другие необязательные свойства будут унаследованы от исходного файла.

SourceConnection

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

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

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

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

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

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

Прототип

HRESULT UpgradeDatabase(BSTR SourceConnection, BSTR DestConnection);

Чтобы обновить базу данных SQL Server Compact с версии 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.

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

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

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