CArchive::CArchive

CArchive ( CFile * pFile, UINT nMode, int nBufSize = 4096, void * lpBuf = NULL ) ;
jeter (
CMemoryException, CArchiveException, CFileException );

Paramètres

pFile

Un pointeur vers l'objet CFile qui est l'ultime source ou la destination des données persistantes.

nMode

Un indicateur qui spécifie si les objets seront chargés à partir d'ou stockés dans l'archive. Le paramètre nMode doit avoir l'une des valeurs suivantes:

nBufSize

Entier qui spécifie la taille de la mémoire tampon interne de fichier, en octets. Notez que la taille de mémoire tampon par défaut est 4096 octets. Si vous archivez régulièrement des objets de grande taille, vous améliorera les performances si vous utilisez une plus grande taille de la mémoire tampon qui est un multiple de la taille de mémoire tampon du fichier.

lpBuf

Un option pointeur sur un buffer fourni par l'utilisateur de taille nBufSize. Si vous ne spécifiez pas ce paramètre, l'archive alloue un tampon dans le tas local et il libère lorsque l'objet est détruit. L'archive ne libère pas un tampon fourni par l'utilisateur.

Remarques

Construit un objet CArchive et spécifie si elle servira pour le chargement ou le stockage d'objets. Vous ne pouvez modifier cette spécification après que vous avez créé l'archive.

Vous ne pouvez pas utiliser CFile opérations pour modifier l'État du fichier jusqu'à ce que vous avez fermé l'archive. Toute cette opération vont nuire à l'intégrité de l'archive. Vous pouvez accéder la position du pointeur de fichier à tout moment pendant la sérialisation par obtenir un objet de fichier de l'archive de la fonction de membre GetFile et puis en utilisant la fonction CFile::GetPosition . Vous devez appeler CArchive::Flush avant d'obtenir la position du pointeur de fichier.

Exemple

extern char * pFileName ;
CFile f ;
char buf [512] ;
Si (! f.Open (pFileName, CFile::modeCreate | {CFile::modeWrite))
 nbsp ; # ifdef _DEBUG
      afxDump << « Impossible d'ouvrir le fichier » << « \n » ;
      sortie (1) ;
   # endif
}
Ar CArchive (& f, CArchive::store, 512, buf);

Aperçu CArchive |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CArchive::Close, CArchive::Flush, CFile::Close

Index