Metodo CompactDatabase (SQL Server Compact)
Il metodo CompactDatabase recupera lo spazio inutilizzato nel database locale di SQL Server 2005 Compact Edition (SQL Server Compact Edition). Questo metodo può inoltre essere utilizzato per modificare i criteri di confronto, le impostazioni di crittografia e quelle della password del database.
Sintassi
object.CompactDatabase(SourceConnection, DestConnection)
Parametri
| Parametro | Descrizione |
|---|---|
SourceConnection |
Valore stringa che specifica una connessione al database di origine di cui eseguire la compattazione. Se il database indicato da SourceConnection è già aperto, si verifica un errore. |
DestConnection |
Valore stringa che specifica una connessione al database di destinazione da creare mediante la compattazione. Se esiste già il database specificato in DestConnection o un altro file con lo stesso nome, si verifica un errore. |
Prototipo
HRESULT CompactDatabase(BSTR SourceConnection, BSTR DestConnection);
Osservazioni
I parametri SourceConnection e DestConnection specificano le proprietà dei database di origine e di destinazione. Nella tabella seguente vengono elencate le proprietà di connessione che è possibile impostare per ogni parametro. Tutte le altre proprietà di connessione vengono ignorate.
| Proprietà | Descrizione |
|---|---|
Provider |
Indica il nome del provider da utilizzare per connettersi all'origine dei dati. Se questa proprietà non viene specificata, verrà utilizzato il provider OLE DB per SQL Server Compact Edition. Se il nome del provider nella stringa di origine è diverso dal nome del provider nella stringa di destinazione, si verifica un errore. |
Data Source |
Indica il nome del database. Questa proprietà è obbligatoria per le informazioni di connessione sia di origine che di destinazione. |
Locale Identifier |
Indica l'identificatore delle impostazioni internazionali (LCID) per il nuovo database. Se viene omesso, il database di destinazione avrà lo stesso LCID delle impostazioni internazionali del sistema. Locale Identifier specifica i criteri per il confronto delle stringhe all'interno del database. |
SSCE:Database Password |
Indica la password, se il database è protetto tramite password. Se il database di origine contiene una password, questa deve essere specificata. Se questo parametro viene omesso dalla stringa DestConnection , il nuovo database avrà la stessa password del database di origine. Se si desidera rimuovere la password dal database di destinazione, è necessario impostare la password del database come stringa vuota. La password del database può essere costituita da un massimo di 40 caratteri. |
SSCE:Encrypt Database |
Indica se eseguire la crittografia del nuovo database. Se questo parametro viene omesso dalla stringa DestConnection , il nuovo database avrà la stessa crittografia del database di origine. Si tratta di un valore booleano che deve essere impostato su TRUE per applicare la crittografia o su FALSE per non applicarla.
|
SSCE:Temp File Directory |
Specifica il percorso del database temporaneo. Se questo parametro viene omesso dalla stringa DestConnection , come percorso del database temporaneo verrà utilizzato il percorso del database corrente. |
I valori identificatore delle impostazioni internazionali sono supportati. Per il valore di Locale Identifier utilizzare l'identificatore LCID univoco. Per un elenco di valori LCID univoci, vedere COLLATE (SQL Server Compact Edition). È necessario verificare che il dispositivo in cui si desidera creare il database supporti le impostazioni internazionali.
Se al momento della creazione del database non si specifica alcun valore LCID, SQL Server Compact Edition utilizzerà le impostazioni internazionali del sistema, diversamente dalle precedenti versioni, in cui, in caso di mancata specifica delle impostazioni internazionali, si utilizzano sempre le impostazioni inglesi.
Vedere anche
Riferimenti
Proprietà ErrorRecords (SQL Server Compact Edition)
Altre risorse
Programmazione dell'oggetto Engine di SQL Server Compact Edition