CArchiveException osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Szerializálási kivétel feltételét jelöli

Szemantika

class CArchiveException : public CException

Tagok

Nyilvános konstruktorok

Név	Description
CArchiveException::CArchiveException	Egy CArchiveException objektumot hoz létre.

Nyilvános adatok tagjai

Név	Description
CArchiveException::m_cause	A kivétel okát jelzi.
CArchiveException::m_strFileName	Megadja a kivételfeltételhez tartozó fájl nevét.

Megjegyzések

Az CArchiveException osztály tartalmaz egy nyilvános adattagot, amely a kivétel okát jelzi.

CArchiveException az objektumok a CArchive tagfüggvényeken belül jönnek létre és jelennek meg. Ezeket az objektumokat a CATCH kifejezés hatókörén belül érheti el. Az okkód független az operációs rendszerétől. A kivételfeldolgozásról további információt a Kivételkezelés (MFC) című témakörben talál.

Öröklési hierarchia

CObject

CException

CArchiveException

Requirements

Fejléc: afx.h

CArchiveException::CArchiveException

Létrehoz egy CArchiveException objektumot, amely az ok értékét tárolja az objektumban.

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

Paraméterek

Okoz
Enumerált típusváltozó, amely a kivétel okát jelzi. Az enumerátorok listájáért tekintse meg az m_cause adattagot.

lpszArchiveName
A kivételt okozó objektum nevét CArchive tartalmazó sztringre mutat.

Megjegyzések

Létrehozhat egy CArchiveException objektumot a halomra, és saját maga dobhatja el, vagy hagyhatja, hogy az AfxThrowArchiveException globális függvény kezelje az Ön számára.

Ne használja közvetlenül ezt a konstruktort; ehelyett hívja meg a globális függvényt AfxThrowArchiveException.

CArchiveException::m_cause

Megadja a kivétel okát.

int m_cause;

Megjegyzések

Ez az adattag egy nyilvános változótípus int. Értékeit számbavételi típus határozza CArchiveException meg. Az enumerátorok és jelentésük a következő:

• CArchiveException::none Nem történt hiba.

• CArchiveException::genericException Meghatározatlan hiba.

• CArchiveException::readOnly Betöltés céljából megnyitott archívumba próbált írni.

• CArchiveException::endOfFile Elérte a fájl végét egy objektum olvasása közben.

• CArchiveException::writeOnly Egy tárolásra megnyitott archívumból próbált olvasni.

• CArchiveException::badIndex Érvénytelen fájlformátum.

• CArchiveException::badClass Nem megfelelő típusú objektumba próbált beolvasni egy objektumot.

• CArchiveException::badSchema Megpróbált beolvasni egy objektumot az osztály egy másik verziójával.

  Megjegyzés:

  Ezek az CArchiveException ok-enumerátorok különböznek az CFileException ok-enumerátoroktól.

  Megjegyzés:

  CArchiveException::generic már nem ajánlott. A genericException használható helyette. Ha az általánost egy alkalmazásban használják, és /clr-lel vannak létrehozva, akkor olyan szintaxishibák lépnek fel, amelyeket nem könnyű megfejteni.

CArchiveException::m_strFileName

Megadja a kivételfeltételhez tartozó fájl nevét.

CString m_strFileName;

Lásd még

CException osztály
hierarchiadiagram
CArchive osztály
AfxThrowArchiveException
Kivételfeldolgozás