ISSCEEngine.UpgradeDatabase (SQL Server Compact)

El método ISSCEEngine.Upgrade actualiza una base de datos de SQL Server Compact 3.5 de la versión 3.1 a la versión 3.5. Si la base de datos de origen está cifrada, la base de datos actualizada también lo estará. La base de datos actualizada estará descifrada a menos que proporcione de forma explícita una contraseña en la cadena de destino.

Sintaxis

object.UpgradeDatabase(SourceConnection, DestConnection)

Parámetros

Parámetro	Descripción
SourceConnection	Valor de cadena que especifica una conexión con la base de datos de origen (la base de datos que se va a actualizar). Se produce un error si la base de datos especificada por SourceConnection ya está abierta.
DestConnection (Opcional)	Valor de cadena que especifica una conexión con la base de datos de destino si existe otro archivo que use el mismo nombre. Si DestConnection se pasa como null, las propiedades necesarias como LCID y Password se derivan del archivo de origen.

Valor devuelto

El tipo devuelto es HRESULT, y se devuelve S_OK cuando es correcto.

Prototipo

HRESULT UpgradeDatabase(BSTR SourceConnection, BSTR DestConnection);

Para actualizar el archivo de base de datos de la versión 3.1 de SQL Server Compact 3.5 a la versión 3.5 sin crear un archivo nuevo, pase la misma propiedad de origen de datos tanto en la cadena de conexión de origen como en la de destino.

Notas

Los parámetros SourceConnection y DestConnection especifican las propiedades de las bases de datos de origen y destino. En la siguiente tabla se proporciona una lista de las propiedades de conexión que se pueden especificar para cada parámetro. Todas las demás propiedades de conexión se omiten.

Propiedad	Descripción
Data Source	Indica el nombre de la base de datos. Esta propiedad es necesaria para la información de conexión tanto de origen como de destino.
Locale Identifier	Indica el identificador de configuración regional (LCID) para la nueva base de datos. Si se omite, la base de datos de destino tendrá el mismo LCID que la configuración regional del sistema. El LCID especifica el orden de intercalación para las comparaciones de cadenas en la base de datos.
SSCE:Database Password	Indica la contraseña, si la base de datos está protegida mediante contraseña. Si la base de datos de origen contiene una contraseña, ésta se debe proporcionar. Si se omite este parámetro en la cadena DestConnection, la base de datos nueva tendrá la misma contraseña que la de origen. Si desea quitar la contraseña de la base de datos de destino, debe establecerla como una cadena vacía. La contraseña de la base de datos puede tener una longitud máxima de 40 caracteres.
SSCE:Temp File Directory	Especifica la ubicación de la base de datos temporal. Si este parámetro se omite en la cadena DestConnection, se utilizará la ubicación de la base de datos actual como ubicación de la base de datos temporal.
SSCE:Encryption Mode	Especifica el modo de cifrado del destino. Si no se especifica, utiliza Platform Default.
SSCE:Case Sensitive	Especifica si la base de datos distingue mayúsculas y minúsculas o no. Debe establecerse en true para habilitar la distinción de mayúsculas y minúsculas, o en false para deshabilitarla. Si no se especifica, el valor predeterminado es false. Nota: Esta propiedad de conexión se incluyó en SQL Server Compact 3.5 SP1.

Para obtener una lista de valores LCID únicos, vea Intercalaciones admitidas (SQL Server Compact). Asegúrese de que la configuración regional se admite en el dispositivo en el que se va a crear la base de datos.

Para obtener una lista de los diferentes modos de cifrado válidos, vea Actualizar desde versiones anteriores (SQL Server Compact).