CArchiveException-Klasse

  • Artikel

Stellt eine Serialisierungs-Ausnahmebedingung dar.

Syntax

class CArchiveException : public CException

Member

Öffentliche Konstruktoren

Name Beschreibung
CArchiveException::CArchiveException Erstellt ein CArchiveException-Objekt.

Öffentliche Datenmember

Name Beschreibung
CArchiveException::m_cause Gibt die Ausnahmeursache an.
CArchiveException::m_strFileName Gibt den Namen der Datei für diese Ausnahmebedingung an.

Hinweise

Die CArchiveException Klasse enthält ein öffentliches Datenelement, das die Ursache der Ausnahme angibt.

CArchiveException Objekte werden in CArchive-Memberfunktionen erstellt und ausgelöst. Sie können auf diese Objekte innerhalb des Bereichs eines CATCH-Ausdrucks zugreifen. Der Ursachecode ist unabhängig vom Betriebssystem. Weitere Informationen zur Ausnahmeverarbeitung finden Sie unter Exception Handling (MFC).

Vererbungshierarchie

CObject

CException

CArchiveException

Anforderungen

Header: afx.h

CArchiveException::CArchiveException

Erstellt ein CArchiveException Objekt, wobei der Wert der Ursache im Objekt gespeichert wird.

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

Parameter

cause
Eine Aufzählungstypvariable, die den Grund für die Ausnahme angibt. Eine Liste der Enumerationselemente finden Sie im m_cause Datenmember.

lpszArchiveName
Verweist auf eine Zeichenfolge, die den Namen des CArchive Objekts enthält, das die Ausnahme verursacht.

Hinweise

Sie können ein CArchiveException Objekt für den Heap erstellen und selbst auslösen oder die globale Funktion AfxThrowArchiveException für Sie behandeln lassen.

Verwenden Sie diesen Konstruktor nicht direkt; Rufen Sie stattdessen die globale Funktion AfxThrowArchiveExceptionauf.

CArchiveException::m_cause

Gibt die Ursache der Ausnahme an.

int m_cause;

Hinweise

Dieses Datenelement ist eine öffentliche Variable vom Typ int. Die Werte werden durch einen CArchiveException Aufzählungstyp definiert. Die Enumeratoren und ihre Bedeutungen lauten wie folgt:

  • CArchiveException::none Es ist kein Fehler aufgetreten.

  • CArchiveException::genericException Nicht angegebener Fehler.

  • CArchiveException::readOnly Es wurde versucht, in ein zum Laden geöffnetes Archiv zu schreiben.

  • CArchiveException::endOfFile Das Ende der Datei beim Lesen eines Objekts erreicht.

  • CArchiveException::writeOnly Es wurde versucht, aus einem Archiv zu lesen, das zum Speichern geöffnet wurde.

  • CArchiveException::badIndex Ungültiges Dateiformat.

  • CArchiveException::badClass Es wurde versucht, ein Objekt in ein Objekt des falschen Typs zu lesen.

  • CArchiveException::badSchema Es wurde versucht, ein Objekt mit einer anderen Version der Klasse zu lesen.

    Hinweis

    Diese CArchiveException-Ursachenenumeratoren unterscheiden sich von den CFileException-Ursachenenumeratoren.

    Hinweis

    CArchiveException::generic ist veraltet. Verwenden Sie stattdessen genericException. Wenn generisch in einer Anwendung verwendet und mit /clr erstellt wird, gibt es Syntaxfehler, die nicht leicht zu entschlüsseln sind.

CArchiveException::m_strFileName

Gibt den Namen der Datei für diese Ausnahmebedingung an.

CString m_strFileName;

Siehe auch

CException-Klasse
Hierarchiediagramm
CArchive-Klasse
AfxThrowArchiveException
Ausnahmeverarbeitung