Método CompactDatabase (SQL Server Compact Edition)

El método CompactDatabase recupera el espacio desaprovechado en la base de datos local de SQL Server 2005 Compact Edition (SQL Server Compact Edition). Este método se puede usar también para cambiar la configuración del orden de intercalación, cifrado y contraseña de la base de datos.

Sintaxis

object.CompactDatabase(SourceConnection, DestConnection)

Parámetros

Parámetro	Descripción
SourceConnection	Valor de cadena que especifica una conexión con la base de datos de origen que se va a compactar. Se produce un error si la base de datos especificada por SourceConnection ya está abierta.
DestConnection	Valor de cadena que especifica una conexión con la base de datos de destino que se va a crear al compactar. Se produce un error si ya existe la base de datos especificada en DestConnection o existe otro archivo con el mismo nombre.

Prototipo

HRESULT CompactDatabase(BSTR SourceConnection, BSTR DestConnection);

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
Provider	Indica el nombre del proveedor que se va a utilizar para conectar con el origen de datos. Si no se especifica esta propiedad, se asume el uso del proveedor OLE DB para SQL Server Compact Edition. Se produce un error si el nombre del proveedor de la cadena de origen es diferente al nombre del proveedor de la cadena de destino.
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. Locale Identifier 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:Encrypt Database	Indica si se cifra la base de datos nueva. Si se omite este parámetro en la cadena DestConnection , la base de datos nueva tendrá el mismo cifrado que la de origen. Es un valor booleano y sus valores son TRUE (si se realiza cifrado) o FALSE (si no se realiza cifrado). [!NOTA] Si se especifica SSCE:Database Password, la base de datos siempre se cifra, independientemente de si se indica SSCE:Encrypt Database.
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.

Se admiten valores de identificador de configuración regional. Utilice el identificador LCID exclusivo para el valor de Locale Identifier. Para obtener una lista de valores LCID únicos, vea COLLATE (SQL Server Compact Edition). Debe comprobar que la configuración regional se admite en el dispositivo en el que se va a crear la base de datos.

Si no especifica ningún valor de LCID al crear la base de datos, SQL Server Compact Edition usa la configuración regional del sistema. Esto supone una diferencia con respecto a las versiones anteriores, que siempre habían utilizado la configuración regional en inglés si no se especificaba ninguna.

Vea también

Referencia

Propiedad ErrorRecords (SQL Server Compact Edition)

Otros recursos

Programación del objeto Engine de SQL Server Compact Edition

Ayuda e información

Obtener ayuda sobre SQL Server Compact Edition