Compartir a través de

SqlCeEngine.Compact Method

  • Artículo

Recupera el espacio desaprovechado de la base de datos de SQL Server Compact 3.5 mediante la creación de un nuevo archivo de base de datos a partir del archivo existente. Este método también se utiliza para cambiar las opciones de orden de intercalación, cifrado o contraseña de la base de datos.

Espacio de nombres: System.Data.SqlServerCe
Ensamblado: System.Data.SqlServerCe (en system.data.sqlserverce.dll)

Sintaxis

'Declaración
Public Sub Compact ( _
    connectionString As String _
)

public void Compact (
    string connectionString
)

public:
void Compact (
    String^ connectionString
)

public void Compact (
    String connectionString
)

public function Compact (
    connectionString : String
)

Parámetros

  • connectionString
    Cadena de conexión con la base de datos de destino.

Notas

La cadena de conexión especifica una conexión con la base de datos de destino que creará este método.

Si la base de datos especificada ya existe, o si existe otro archivo con el mismo nombre, se produce una excepción. .

Si se pasa una cadena vacía como cadena de conexión, el nuevo archivo de base de datos sobrescribe el archivo de base de datos antiguo y mantiene el mismo nombre.

Importante

Si una aplicación termina de forma anómala antes de completarse la operación Compact, quedará un archivo de base de datos temporal en el sistema. La denominación de este archivo es <nombreDeArchivo>pack.sdf y se debe quitar manualmente.

Ejemplo

En el siguiente ejemplo se muestra cómo compactar una base de datos de SQL Server Compact 3.5.

Dim engine As New SqlCeEngine("Data Source = AdventureWorks.sdf")

' Specify null destination connection string for in-place compaction
'
engine.Compact(Nothing)

' Specify connection string for new database options; The following 
' tokens are valid:
'      - Password
'      - LCID
'      - Encrypt
' 
' All other SqlCeConnection.ConnectionString tokens are ignored
'
engine.Compact("Data Source=; Password =a@3!7f$dQ;")

SqlCeEngine engine = new SqlCeEngine("Data Source = AdventureWorks.sdf");

// Specify null destination connection string for in-place compaction
//
engine.Compact(null);

// Specify connection string for new database options; The following 
// tokens are valid:
//      - Password
//      - LCID
//      - Encrypt
// 
// All other SqlCeConnection.ConnectionString tokens are ignored
//
engine.Compact("Data Source=; Password =a@3!7f$dQ;");

Seguridad para subprocesos

Todos los miembros (Compartidos en Microsoft Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Plataformas

Plataformas de desarrollo

Windows Vista, Windows Mobile 5.0, Windows XP Professional with Service Pack 2 (SP2), Windows Server 2003, Windows Mobile 2003 for Pocket PC, Windows CE 5.0
Información de la versión
.NET Framework y NET Compact Framework
Se admite en 3.5
.NET Framework
Se admite en 3.0
.NET Compact Framework y .Net Framework
Se admite en 2.0

Vea también

Referencia

SqlCeEngine Class
SqlCeEngine Members
System.Data.SqlServerCe Namespace