Класс CArchiveException

  • Статья

Представляет условие исключения сериализации

Синтаксис

class CArchiveException : public CException

Участники

Открытые конструкторы

Имя Описание
CArchiveException::CArchiveException Формирует объект CArchiveException.

Открытые члены данных

Имя Описание
CArchiveException::m_cause Указывает причину исключения.
CArchiveException::m_strFileName Указывает имя файла для этого условия исключения.

Замечания

Класс CArchiveException включает в себя общедоступный элемент данных, указывающий причину исключения.

CArchiveException объекты создаются и создаются внутри функций-членов CArchive . Эти объекты можно получить в область выражения CATCH. Код причины не зависит от операционной системы. Дополнительные сведения об обработке исключений см. в разделе "Обработка исключений( MFC)".

Иерархия наследования

CObject

Cexception

CArchiveException

Требования

Заголовок: afx.h

CArchiveException::CArchiveException

CArchiveException Создает объект, сохраняя значение причины в объекте.

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

Параметры

cause
Перечисленная переменная типа, указывающая причину исключения. Список перечислителей см. в элементе данных m_cause .

lpszArchiveName
Указывает на строку, содержащую имя CArchive объекта, вызывающего исключение.

Замечания

Вы можете создать CArchiveException объект в куче и вызвать его самостоятельно или разрешить глобальной функции AfxThrowArchiveException его обрабатывать.

Не используйте этот конструктор напрямую; вместо этого вызовите глобальную функцию AfxThrowArchiveException.

CArchiveException::m_cause

Указывает причину исключения.

int m_cause;

Замечания

Этот элемент данных является общедоступной переменной типа int. Его значения определяются перечисленным типом CArchiveException . Перечислители и их значение представлено далее.

  • CArchiveException::none Ошибка не произошла.

  • CArchiveException::genericException Не указано сообщение об ошибке.

  • CArchiveException::readOnly Пыталась записать в архив, открытый для загрузки.

  • CArchiveException::endOfFile Достигнут конец файла при чтении объекта.

  • CArchiveException::writeOnly Пытался прочитать из архива, открываемого для хранения.

  • CArchiveException::badIndex Недопустимый формат файла.

  • CArchiveException::badClass Пыталась считывать объект в объект неправильного типа.

  • CArchiveException::badSchema Попыталась прочитать объект с другой версией класса.

    Примечание.

    Перечислители причины CArchiveException отличаются от перечислителей причины CFileException.

    Примечание.

    CArchiveException::generic не рекомендуется к использованию. Вместо этого используйте genericException. Если универсальный используется в приложении и построен с помощью /clr, будут синтаксические ошибки, которые не легко расшифровать.

CArchiveException::m_strFileName

Указывает имя файла для этого условия исключения.

CString m_strFileName;

См. также

Класс CException
Диаграмма иерархии
Класс CArchive
AfxThrowArchiveException
Обработка исключений