CDaoWorkspace::CompactDatabase

Artigo
08/25/2010

Chame essa função de membro para compactar um banco de dados Microsoft Jet (.mdb) especificado.

static void PASCAL CompactDatabase( 
   LPCTSTR lpszSrcName, 
   LPCTSTR lpszDestName, 
   LPCTSTR lpszLocale = dbLangGeneral, 
   int nOptions = 0  
);
static void PASCAL CompactDatabase( 
   LPCTSTR lpszSrcName, 
   LPCTSTR lpszDestName, 
   LPCTSTR lpszLocale, 
   int nOptions, 
   LPCTSTR lpszPassword  
);

Parâmetros

lpszSrcName
O nome de um existente, fechado o banco de dados.Ele pode ser um caminho completo e um nome de arquivo, sistema autônomo "C:\\MYDB.MDB".Se o nome do arquivo tem uma extensão, você deve especificá-lo.Se sua rede oferecer suporte uniforme) UNC (convenção de nomes, você também pode especificar um caminho de rede, sistema autônomo "\\\\MYSERVER\\MYSHARE\\MYDIR\\MYDB.MDB".(Barras invertidas duplas são necessárias em seqüências de caracteres de caminho como "\" é o caractere de escape do C++.)
lpszDestName
O caminho completo do banco de dados compactado que você está criando.Você também pode especificar um caminho de rede sistema autônomo em lpszSrcName. Não é possível usar o lpszDestName argumento para especificar o mesmo arquivo de banco de dados sistema autônomo lpszSrcName.
lpszPassword
Uma senha, usada quando você deseja compactar um banco de dados protegido por senha.Observe que, se você usar a versão de CompactDatabase que leva uma senha, você deve fornecer todos os parâmetros. Além disso, sistema autônomo este é um parâmetro de conectar, exige formatação especial, da seguinte maneira: ;PWD=lpszPassword. Por exemplo: PWD = "Bom".(É necessário o ponto-e-vírgula entrelinhamento.)
lpszLocale
Uma expressão em seqüência usada para especificar a ordem de agrupamento para criar lpszDestName. Se você omitir esse argumento ao aceitar o valor padrão de dbLangGeneral (veja abaixo), a localidade do databsistema autônomoe novo é a mesma sistema autônomo que databsistema autônomoe antigo.Os valores possíveis são:
- dbLangGeneral Inglês, alemão, francês, português, italiano e moderno espanhol
- dbLangArabic Árabe
- dbLangCyrillic Russo
- dbLangCzech Tcheco
- dbLangDutch Holandês
- dbLangGreek Grego
- dbLangHebrew Hebraico
- dbLangHungarian Húngaro
- dbLangIcelandic Islandês
- dbLangNordic Idiomas nórdicos (Microsoft versão do mecanismo de banco de dados Jet 1.0 somente)
- dbLangNorwdan Norueguês e dinamarquês
- dbLangPolish Polonês
- dbLangSpanish Espanhol tradicional
- dbLangSwedfin Sueco e finlandês
- dbLangTurkish Turco

nOptions
Indica uma ou mais opções para o banco de dados de destino, lpszDestName. Se você omitir esse argumento ao aceitar o valor padrão, a lpszDestName terão a mesma criptografia e a mesma versão sistema autônomo lpszSrcName. Você pode agrupar o dbEncrypt or dbDecrypt opção com uma das opções de versão com o operador bit a bit ou.Os valores possíveis, especifique um formato de banco de dados, não uma versão do mecanismo de banco de dados, são:

dbEncrypt Criptografe o banco de dados durante a compactação.
dbDecrypt Descriptografe o banco de dados durante a compactação.
dbVersion10 criar um banco de dados que usa a versão 1.0 do mecanismo de banco de dados Microsoft Jet durante a compactação.
dbVersion11 criar um banco de dados que usa o mecanismo de banco de dados do Microsoft Jet versão 1.1 durante a compactação.
dbVersion20 criar um banco de dados que usa o mecanismo de banco de dados do Microsoft Jet versão 2.0 durante a compactação.
dbVersion30 Crie um banco de dados que usa a versão do mecanismo de banco de dados Microsoft Jet 3.0 durante a compactação.

Você pode usar dbEncrypt or dbDecrypt no argumento Opções para especificar se deseja criptografar ou descriptografar o banco de dados sistema autônomo ele será compactado.Se você omitir uma constante de criptografia ou se você incluir sistema autônomo dois dbDecrypt and dbEncrypt, lpszDestName terão a mesma criptografia sistema autônomo lpszSrcName. Você pode usar uma das constantes versão no argumento Opções para especificar a versão do formato de dados para o banco de dados compactado.Esta constante afeta somente a versão do formato de dados de lpszDestName. Você pode especificar somente uma constante de versão.Se você omitir uma constante, versão lpszDestName vai ter a mesma versão sistema autônomo lpszSrcName. Você pode compactar lpszDestName somente para uma versão igual ou posterior do que lpszSrcName.

Cuidado:
Se um banco de dados não estiverem criptografado, é possível, mesmo se você implementa a segurança da senha do usuário, para ler diretamente o arquivo binário que c onstitutes o banco de dados.

Comentários

À medida que você altera dados em um banco de dados, o arquivo de banco de dados pode ficar fragmentado e usar mais espaço em disco que o necessário.Periodicamente, você deve compactar o banco de dados para desfragmentar o arquivo de banco de dados.O banco de dados compactado é geralmente menor.Também é possível alterar a ordem de agrupamento, a criptografia ou a versão do formato dos dados enquanto copia e compactar o banco de dados.

Cuidado:
O CompactDatabase função de membro não corretamente converterá um completo banco de dados do Microsoft acesso de uma versão para outra. Somente o formato de dados é convertido.Microsoft definido pelo acesso objetos, tais sistema autônomo formulários e relatórios, não são convertidos.No entanto, os dados são convertidos corretamente.