Partilhar via


Método SqlCeEngine.Compact

Recupera o espaço desperdiçado no banco de dados do SQL Server Compact por meio da criação de um novo arquivo de banco de dados a partir do arquivo existente. Esse método também é usado para alterar as configurações de ordem de agrupamento, criptografia ou senha do banco de dados.

Namespace:  System.Data.SqlServerCe
Assembly:  System.Data.SqlServerCe (em System.Data.SqlServerCe.dll)

Sintaxe

'Declaração
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
    A cadeia de conexão com o banco de dados de destino.

Comentários

A cadeia de conexão especifica uma conexão com o banco de dados de destino que será criado por esse método.

Será lançada uma exceção se o banco de dados especificado já existir ou se existir um outro arquivo com o mesmo nome. .

Se você passar uma cadeia de caracteres vazia como cadeia de conexão, o novo arquivo de banco de dados substituirá o arquivo de banco de dados antigo e manterá o mesmo nome.

Importante

O encerramento anormal de um aplicativo antes de a operação Compact ser concluída deixa um arquivo de banco de dados temporário no sistema. O nome desse arquivo é <nomedoarquivo>pack.sdf e deve ser removido manualmente.

Exemplos

O exemplo a seguir demonstra como compactar um banco de dados do 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;");

Consulte também

Referência

SqlCeEngine Classe

Namespace System.Data.SqlServerCe