CArchive::CArchive

CArchive (CFile *pFile,UINTnMode,intnBufSize=4096,void *lpBufNulo=);
lançar ( CMemoryException, CArchiveException, CFileException );

Parâmetros

pFile

Um ponteiro para o objeto CFile que é o ultimate origem ou destino dos dados persistentes.

nMode

Um sinalizador que especifica se objetos vão ser carregados a partir ou armazenados para o arquivo morto. O parâmetro nMode deve ter um dos seguintes valores:

• CArchive::load   Carrega dados de arquivo morto. Requer a que permissão de leitura apenas CFile.
  
  
• CArchive::store   Salva os dados no arquivamento. Requer permissão de gravação de CFile.
  
  
• CArchive::b&NoFlushOnDeletenbsp;  Impede que o arquivo morto automaticamente chamar Flush quando o destruidor de arquivamento é chamado. Se você definir esse sinalizador, você é responsável para chamar explicitamente Close antes do destruidor é chamado. Se você não fizer isso, seus dados serão corrompidos.

nBufSize

Um integer que especifica o tamanho do buffer interno de arquivo, em bytes. Observe que o tamanho do buffer padrão é 4096 bytes. Se você costuma arquivar objetos grandes, você melhorará o desempenho se você usar um tamanho de buffer maior que é um múltiplo do tamanho do buffer do arquivo.

lpBuf

Um opcional ponteiro para um buffer fornecido pelo usuário de tamanho nBufSize. Se você não especificar esse parâmetro, o arquivo aloca um buffer de pilha local e libera-lo quando o objeto é destruído. O arquivamento não liberar um buffer fornecido pelo usuário.

Observações

Constrói um objeto de CArchive e especifica se ele será usado para Carregando ou armazenar objetos. Você não pode alterar esta especificação após você ter criado o arquivo.

Você não pode usar operações de CFile para alterar o estado do arquivo até que você tenha fechado o arquivo morto. Essa operação, irá prejudicar a integridade do arquivamento. Você pode acessar a posição do ponteiro do arquivo a qualquer momento durante a serialização por obter o objeto de arquivo do arquivo da função de membro GetFile e, em seguida, usando a função CFile::GetPosition . Você deve chamar CArchive::Flush antes de obter a posição do ponteiro de arquivo.

Exemplo

extern char * pFileName;
CFile f;
Char buf [512];
se (! f.Open (pFileName, CFile::modeCreate | CFile::modeWrite)) {
 nbsp; # ifdef  Debug
      afxDump << "Unable to open file" << "\n";
      saia (1);
   # endif
}
Ar de CArchive (& f, CArchive::store, 512, buf);

Visão geral de CArchive |  Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CArchive:: fechar, CArchive::Flush, CFile:: fechar