Partilhar via

Classe CArchiveException

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

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

Sintaxe

class CArchiveException : public CException

Membros

Construtores Públicos

Nome Description
CArchiveException::CArchiveException Constrói um CArchiveException objeto.

Membros de Dados Públicos

Nome Description
CArchiveException::m_cause Indica a causa da exceção.
CArchiveException::m_strFileName Especifica o nome do ficheiro para esta condição de exceção.

Observações

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

CArchiveException os objetos são construídos e colocados dentro de funções membros CArchive . Pode aceder a estes objetos dentro do âmbito de uma expressão CATCH . O código de causa é independente do sistema operativo. Para mais informações sobre o processamento de exceções, consulte Gestão de Exceções (MFC).

Hierarquia de herança

CObject

CException

CArchiveException

Requerimentos

Cabeçalho: afx.h

CArchiveException::CArchiveException

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

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

Parâmetros

Causa
Uma variável de tipo enumerada que indica a razão da exceção. Para uma lista dos enumeradores, veja o m_cause membro dos dados.

lpszArchiveName
Aponta para uma cadeia que contém o nome do CArchive objeto que causa a exceção.

Observações

Podes criar um CArchiveException objeto no heap e lançá-lo tu próprio ou deixar a função global AfxThrowArchiveException tratar disso por ti.

Não use este construtor diretamente; em vez disso, chame-se a função AfxThrowArchiveExceptionglobal .

CArchiveException::m_cause

Especifica a causa da exceção.

int m_cause;

Observações

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

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

  • CArchiveException::genericException Erro não especificado.

  • CArchiveException::readOnly Tentei escrever num arquivo aberto para carregamento.

  • CArchiveException::endOfFile Cheguei ao fim do ficheiro enquanto lia um objeto.

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

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

  • CArchiveException::badClass Tentei interpretar um objeto num objeto do tipo errado.

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

    Observação

    Estes CArchiveException enumeradores de causa são distintos dos CFileException enumeradores de causas.

    Observação

    CArchiveException::generic está obsoleto. Utilize genericException em substituição. Se genérico for usado numa aplicação e construído com /clr, haverá erros de sintaxe que não são fáceis de decifrar.

CArchiveException::m_strFileName

Especifica o nome do ficheiro para esta condição de exceção.

CString m_strFileName;

Consulte também

Aula CException
Gráfico de Hierarquia
Classe de Cadriva
AfxThrowArchiveException
Processamento de Exceções

  • Last updated on