ISSCEEngine.UpgradeDatabase (SQL Server Compact)

O método ISSCEEngine.Upgrade atualiza um banco de dados do SQL Server Compact da versão 3.5 para a 4.0. Se o banco de dados de origem estiver criptografado, o banco de dados atualizado também será criptografado. O banco de dados atualizado não será criptografado, a não ser que você forneça explicitamente uma senha na cadeia de caracteres de destino.

Sintaxe

object.UpgradeDatabase(SourceConnection, DestConnection)

Parâmetros

Parâmetro	Descrição
SourceConnection	Um valor de cadeia de caracteres que especifica uma conexão com o banco de dados de origem (o banco de dados a ser atualizado). Ocorrerá um erro se o banco de dados especificado por SourceConnection já estiver aberto.
DestConnection (Opcional)	Um valor da cadeia de caracteres que especifica uma conexão com o banco de dados de destino se existir outro arquivo com o mesmo nome. Se o parâmetro DestConnection for passado como null, as propriedades necessárias, como LCID e Password serão derivadas do arquivo de origem.

Valor de retorno

O tipo de retorno é HRESULT, e S_OK é retornado quando bem-sucedido.

Protótipo

HRESULT UpgradeDatabase(BSTR SourceConnection, BSTR DestConnection);

Para atualizar o arquivo de banco de dados do SQL Server Compact versão 3.1 para a versão 3.5 sem criar um novo arquivo, passe a mesma propriedade de fonte de dados nas cadeias de conexão de origem e de destino.

Comentários

Os parâmetros SourceConnection e DestConnection especificam as propriedades dos bancos de dados de origem e destino. A tabela a seguir lista as propriedades de conexão que você pode especificar para cada parâmetro. Todas as outras propriedades de conexão são ignoradas.

Propriedade	Descrição
Data Source	Indica o nome do banco de dados. Essa propriedade é necessária para informações sobre conexões de origem e destino.
Locale Identifier	Indica o LCID (identificador de localidade) do novo banco de dados. Se for omitido, o banco de dados de destino terá o mesmo LCID que a localidade do sistema. LCID especifica a ordem de agrupamento para comparações de cadeias de caracteres no banco de dados.
SSCE:Database Password	Indica a senha, se o banco de dados for protegido por uma senha. A senha do banco de dados de origem deverá ser fornecida se esse banco de dados contiver uma senha. Se esse parâmetro for omitido da cadeia de caracteres DestConnection, o novo banco de dados terá a mesma senha que o banco de dados de origem. Se você desejar remover a senha do banco de dados de destino, a senha deverá ser definida como uma cadeia vazia. A senha do banco de dados pode ter até 40 caracteres de comprimento.
SSCE:Temp File Directory	Especifica o local do banco de dados temporário. Se esse parâmetro for omitido da cadeia de caracteres DestConnection, o local do banco de dados atual será usado como o local do banco de dados temporário.
SSCE:Encryption Mode	Especifica o modo de criptografia de destino. Se não for especificado, será usado Platform Default.
SSCE:Case Sensitive	Especifica se o banco de dados deve ou não diferenciar maiúsculas de minúsculas. Deve ser definido como true para habilitar a diferenciação de maiúsculas e minúsculas ou false para desabilitá-la. Se não for especificado, o valor padrão será false. Observação Essa propriedade de conexão foi introduzida no SQL Server Compact SP1.

Para localizar uma lista de valores LCID exclusivos, consulte Agrupamentos suportados (SQL Server Compact). Verifique se há suporte para a localidade no aplicativo no qual o banco de dados está sendo criado.

Para obter uma lista dos diferentes modos de criptografia válidos, consulte Atualizando versões anteriores (SQL Server Compact).