SqlCeEngine.Compact Method

Artigo
01/14/2011

Recupera o espaço desperdiçado no banco de dados do SQL Server Compact 3.5 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 _
)

public void Compact (
    string connectionString
)

public:
void Compact (
    String^ connectionString
)

public void Compact (
    String connectionString
)

public function Compact (
    connectionString : String
)

Parâmetros

connectionString
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.

Exemplo

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

Segurança de thread

Quaisquer membros estáticos públicos (compartilhados no Microsoft Visual Basic) desse tipo são thread safe. Não há garantia de que qualquer membro de instância seja thread safe.

Plataformas

Plataformas de desenvolvimento

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
Informações de versão
.NET Framework e NET Compact Framework
Com suporte no 3.5
.NET Framework
Com suporte no 3.0
.NET Compact Framework e .Net Framework
Com suporte no 2.0

Consulte também

Referência

SqlCeEngine Class
SqlCeEngine Members
System.Data.SqlServerCe Namespace

Compartilhar via