Sdílet prostřednictvím

CArchiveException – třída

  • Článek

Představuje podmínku výjimky serializace.

Syntaxe

class CArchiveException : public CException

Členové

Veřejné konstruktory

Název Popis
CArchiveException::CArchiveException CArchiveException Vytvoří objekt.

Veřejné datové členy

Název Popis
CArchiveException::m_cause Označuje příčinu výjimky.
CArchiveException::m_strFileName Určuje název souboru pro tuto podmínku výjimky.

Poznámky

Třída CArchiveException obsahuje veřejný datový člen, který označuje příčinu výjimky.

CArchiveException objekty jsou sestaveny a vyvolány uvnitř CArchive členské funkce. K těmto objektům můžete přistupovat v rámci oboru výrazu CATCH . Kód příčiny je nezávislý na operačním systému. Další informace o zpracování výjimek naleznete v tématu Zpracování výjimek (MFC).

Hierarchie dědičnosti

Objekt CObject

CException

CArchiveException

Požadavky

Hlavička: afx.h

CArchiveException::CArchiveException

CArchiveException Vytvoří objekt a uloží hodnotu příčiny v objektu.

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

Parametry

Příčina
Výčtová proměnná typu, která označuje důvod výjimky. Seznam výčtů najdete v m_cause datovém členu.

lpszArchiveName
Odkazuje na řetězec obsahující název objektu CArchive , který způsobuje výjimku.

Poznámky

Můžete vytvořit CArchiveException objekt na haldě a hodit ho sami nebo nechat globální funkci AfxThrowArchiveException zpracovat za vás.

Nepoužívejte tento konstruktor přímo; místo toho zavolejte globální funkci AfxThrowArchiveException.

CArchiveException::m_cause

Určuje příčinu výjimky.

int m_cause;

Poznámky

Tento datový člen je veřejná proměnná typu int. Jeho hodnoty jsou definovány výčtovým typem CArchiveException . Enumerátory a jejich významy jsou následující:

  • CArchiveException::none Nedošlo k žádné chybě.

  • CArchiveException::genericException Nezadaná chyba

  • CArchiveException::readOnly Pokusili jste se napsat do archivu otevřeného pro načítání.

  • CArchiveException::endOfFile Byl dosažen konec souboru při čtení objektu.

  • CArchiveException::writeOnly Pokusili jste se číst z archivu otevřeného pro ukládání.

  • CArchiveException::badIndex Neplatný formát souboru

  • CArchiveException::badClass Pokusili jste se načíst objekt do objektu nesprávného typu.

  • CArchiveException::badSchema Pokusili jste se přečíst objekt s jinou verzí třídy.

    Poznámka:

    Tyto CArchiveException příčiny enumerátory se liší od CFileException příčin výčtů.

    Poznámka:

    CArchiveException::generic je zastaralý. Místo toho použijte genericException. Pokud se v aplikaci používá obecný a je sestaven pomocí /clr, dojde k chybám syntaxe, které se nedají snadno dešifrovat.

CArchiveException::m_strFileName

Určuje název souboru pro tuto podmínku výjimky.

CString m_strFileName;

Viz také

CException – třída
Graf hierarchie
CArchive – třída
AfxThrowArchiveException
Zpracování výjimek