SqlCeEngine.Compact Method

Articolo
01/14/2011

Recupera lo spazio inutilizzato nel database di SQL Server Compact 3.5 creando un nuovo file di database dal file esistente. Questo metodo viene utilizzato anche per modificare le impostazioni di ordine di fascicolatura, crittografia o password del database.

Spazio dei nomi: System.Data.SqlServerCe
Assembly: System.Data.SqlServerCe (in system.data.sqlserverce.dll)

Sintassi

'Dichiarazione
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
)

Parametri

connectionString
Stringa di connessione al database di destinazione.

Osservazioni

La stringa di connessione specifica una connessione al database di destinazione che verrà creato da questo metodo.

Se il database specificato esiste già o se esiste già un altro file con lo stesso nome, verrà generata un'eccezione. .

Se viene passata una stringa vuota per la stringa di connessione, il nuovo file di database sovrascriverà il file di database precedente e manterrà lo stesso nome.

Importante

In caso di interruzione anomala di un'applicazione prima del completamento di un'operazione Compact, nel sistema rimane un file di database temporaneo. Tale file viene denominato <nomefile>pack.sdf e deve essere rimosso manualmente.

Esempio

Nell'esempio seguente viene illustrato come compattare un database di 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;");

Affidabilità

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono affidabili. Non è invece garantita l'affidabilità dei membri dell'istanza.

Piattaforme

Piattaforme di sviluppo

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
Informazioni sulla versione
.NET Framework e .NET Compact Framework
Supportato in 3.5
.NET Framework
Supportato in 3.0
.NET Compact Framework e .NET Framework
Supportato in 2.0

Vedere anche

Riferimento

SqlCeEngine Class
SqlCeEngine Members
System.Data.SqlServerCe Namespace

Condividi tramite