Classe CArchiveException

  • Artigo

Representa uma condição de exceção de serialização

Sintaxe

class CArchiveException : public CException

Membros

Construtores públicos

Nome Descrição
CArchiveException::CArchiveException Constrói um objeto CArchiveException.

Membros de Dados Públicos

Nome Descrição
CArchiveException::m_cause Indica a causa da exceção.
CArchiveException::m_strFileName Especifica o nome do arquivo para essa condição de exceção.

Comentários

A classe CArchiveException inclui um membro de dados públicos que indica a causa da exceção.

Os objetos CArchiveException são construídos e lançados dentro de funções de membro CArchive. Você pode acessar esses objetos no escopo de uma expressão CATCH. O código de causa é independente do sistema operacional. Para mais informações sobre o processamento da exceção, confira Tratamento de exceção (MFC).

Hierarquia de herança

CObject

CException

CArchiveException

Requisitos

Cabeçalho: afx.h

CArchiveException::CArchiveException

Constrói um objeto CArchiveException, armazenando o valor da causa no objeto.

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

Parâmetros

causa
A variável de tipo enumerado que indica o motivo da exceção. Para obter uma lista dos enumeradores, consulte o membro de dados m_cause.

lpszArchiveName
Aponta para uma cadeia de caracteres que contém o nome do objeto CArchive que está causando a exceção.

Comentários

Você pode criar um objeto CArchiveException no heap e lançá-lo por conta própria, ou deixar que a função global AfxThrowArchiveException o manipule para você.

Não use este construtor diretamente; em vez disso, chame a função global AfxThrowArchiveException.

CArchiveException::m_cause

Especifica a causa da exceção.

int m_cause;

Comentários

Esse membro de dados é uma variável pública do tipo int. Seus valores são definidos por um tipo enumerado de CArchiveException. Os enumeradores e seus significados são os seguintes:

  • CArchiveException::none Não ocorreu nenhum erro.

  • CArchiveException::genericException Erro não especificado.

  • CArchiveException::readOnly Tentou gravar em um arquivo aberto para carregamento.

  • CArchiveException::endOfFile Fim do arquivo atingido durante a leitura de um objeto.

  • CArchiveException::writeOnly Tentou ler de um arquivo aberto para armazenamento.

  • CArchiveException::badIndex Formato de arquivo inválido.

  • CArchiveException::badClass Tentou ler um objeto em um objeto do tipo errado.

  • CArchiveException::badSchema Tentou ler um objeto com uma versão diferente da classe.

    Observação

    Esses enumeradores de causa de CArchiveException são diferentes dos enumeradores de causa de CFileException.

    Observação

    CArchiveException::generic foi preterido. Use o genericException em vez disso. Se generic for usado em um aplicativo e compilado com /clr, os erros de sintaxe resultantes não serão fáceis de decifrar.

CArchiveException::m_strFileName

Especifica o nome do arquivo para essa condição de exceção.

CString m_strFileName;

Confira também

Classe CException
Gráfico da hierarquia
Classe CArchive
AfxThrowArchiveException
Processamento de exceção