SqlCeEngine.Compact Método

Recupera el espacio desaprovechado de la base de datos de SQL Server Compact 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 _
)
'Uso
Dim instance As SqlCeEngine
Dim connectionString As String

instance.Compact(connectionString)
public void Compact(
    string connectionString
)
public:
void Compact(
    String^ connectionString
)
member Compact : 
        connectionString:string -> unit 
public function Compact(
    connectionString : String
)

Parámetros

  • connectionString
    Tipo: System.String
    Cadena de conexión con la base de datos de destino.

Comentarios

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.

Ejemplos

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

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;");

Vea también

Referencia

SqlCeEngine Clase

Espacio de nombres System.Data.SqlServerCe