CArchiveException, classe

Représente une condition d’exception de sérialisation

Syntaxe

class CArchiveException : public CException

Membres

Constructeurs publics

Nom	Description
CArchiveException ::CArchiveException	Construit un objet CArchiveException.

Membres de données publics

Nom	Description
CArchiveException ::m_cause	Indique la cause de l’exception.
CArchiveException ::m_strFileName	Spécifie le nom du fichier pour cette condition d’exception.

Notes

La CArchiveException classe inclut un membre de données public qui indique la cause de l’exception.

CArchiveException les objets sont construits et levées à l’intérieur des fonctions membres CArchive . Vous pouvez accéder à ces objets dans l’étendue d’une expression CATCH . Le code de cause est indépendant du système d’exploitation. Pour plus d’informations sur le traitement des exceptions, consultez Gestion des exceptions (MFC).

Hiérarchie d'héritage

CObject

CException

CArchiveException

Spécifications

En-tête : afx.h

CArchiveException ::CArchiveException

Construit un CArchiveException objet, stockant la valeur de cause dans l’objet.

CArchiveException(
    int cause = CArchiveException::none,
    LPCTSTR lpszArchiveName = NULL);

Paramètres

cause
Variable de type énumérée qui indique la raison de l’exception. Pour obtenir la liste des énumérateurs, consultez le membre de données m_cause .

lpszArchiveName
Pointe vers une chaîne contenant le nom de l’objet à l’origine CArchive de l’exception.

Notes

Vous pouvez créer un CArchiveException objet sur le tas et le lever vous-même ou laisser la fonction globale AfxThrowArchiveException la gérer pour vous.

N’utilisez pas ce constructeur directement ; à la place, appelez la fonction AfxThrowArchiveExceptionglobale .

CArchiveException ::m_cause

Spécifie la cause de l’exception.

int m_cause;

Notes

Ce membre de données est une variable publique de type int. Ses valeurs sont définies par un CArchiveException type énuméré. Voici les énumérateurs et leurs significations :

• CArchiveException::none Aucune erreur n’a eu lieu.

• CArchiveException::genericException Erreur non spécifiée.

• CArchiveException::readOnly Tentative d’écriture dans une archive ouverte pour le chargement.

• CArchiveException::endOfFile Atteint la fin du fichier lors de la lecture d’un objet.

• CArchiveException::writeOnly Tentative de lecture à partir d’une archive ouverte pour le stockage.

• CArchiveException::badIndex Format de fichier non valide.

• CArchiveException::badClass Tentative de lecture d’un objet dans un objet du type incorrect.

• CArchiveException::badSchema Tentative de lecture d’un objet avec une autre version de la classe.

  Remarque

  Ces énumérateurs de cause CArchiveException sont distincts des énumérateurs de cause CFileException.

  Remarque

  CArchiveException::generic est déconseillé. Utilisez genericException à la place. Si le générique est utilisé dans une application et généré avec /clr, il y aura des erreurs de syntaxe qui ne sont pas faciles à déchiffrer.

CArchiveException ::m_strFileName

Spécifie le nom du fichier pour cette condition d’exception.

CString m_strFileName;

Voir aussi

CException, classe
Graphique hiérarchique
CArchive, classe
AfxThrowArchiveException
Traitement des exceptions