Clase CArchiveException

Representa una condición de excepción de serialización.

Sintaxis

class CArchiveException : public CException

Miembros

Constructores públicos

Nombre	Descripción
CArchiveException::CArchiveException	Construye un objeto CArchiveException.

Miembros de datos públicos

Nombre	Descripción
CArchiveException::m_cause	Indica la causa de la excepción.
CArchiveException::m_strFileName	Especifica el nombre del archivo para esta condición de excepción.

Comentarios

La clase CArchiveException incluye un miembro de datos público que indica la causa de la excepción.

Los objetos CArchiveException se construyen e inician dentro de las funciones miembro CArchive. Se puede acceder a estos objetos dentro del ámbito de una expresión CATCH. El código de causa es independiente del sistema operativo. Para más información sobre el procesamiento de excepciones, consulte Control de excepciones (MFC).

Jerarquía de herencia

CObject

CException

CArchiveException

Requisitos

Encabezado: afx.h

CArchiveException::CArchiveException

Construye un objeto CArchiveException, almacenando el valor de cause en el objeto.

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

Parámetros

cause
Una variable de tipo enumerado que indica el motivo de la excepción. Para obtener una lista de los enumeradores, consulte el miembro de datos m_cause.

lpszArchiveName
Apunta a una cadena que contiene el nombre del objeto CArchive que provoca la excepción.

Comentarios

Puede crear un objeto CArchiveException en el montón y generarlo usted mismo o dejar que la función global AfxThrowArchiveException lo controle automáticamente.

No utilice este constructor directamente; en su lugar, llame a la función global AfxThrowArchiveException.

CArchiveException::m_cause

Especifica el motivo de la excepción.

int m_cause;

Comentarios

Este miembro de datos es una variable pública de tipo int. Sus valores se definen mediante un tipo enumerado CArchiveException. A continuación se indican los enumeradores y el significado de cada uno de ellos:

• CArchiveException::none: no se ha producido ningún error.

• CArchiveException::genericException: error no especificado.

• CArchiveException::readOnly: se ha intentado escribir en un archivo abierto para cargar.

• CArchiveException::endOfFile: se ha alcanzado el final del archivo al leer un objeto.

• CArchiveException::writeOnly: se ha intentado leer desde un archivo abierto para almacenar.

• CArchiveException::badIndex: formato de archivo no válido.

• CArchiveException::badClass: se ha intentado leer un objeto en un objeto del tipo equivocado.

• CArchiveException::badSchema: se ha intentado leer un objeto con una versión diferente de la clase.

  Nota:

  Estos enumeradores de causa de CArchiveException son distintos de los enumeradores de causa de CFileException.

  Nota:

  CArchiveException::generic está en desuso. En su lugar, use genericException. Si se usa generic en una aplicación y se crea con /clr, los errores de sintaxis resultantes no serán fáciles de descifrar.

CArchiveException::m_strFileName

Especifica el nombre del archivo para esta condición de excepción.

CString m_strFileName;

Consulte también

CException (clase)
Gráfico de jerarquías
CArchive (clase)
AfxThrowArchiveException
Procesamiento de excepciones