Класс CArchiveException

Примечание.

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

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

Синтаксис

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
Обработка исключений