Compartilhar via


CATCH

Define um bloco de código que captura o primeiro tipo de exceção lançado no anterior tente bloco.

CATCH(exception_class, exception_object_pointer_name )

Parâmetros

  • exception_class
    Especifica o tipo de exceção para testar.Para obter uma lista de classes de exceção padrão, consulte a classe CException.

  • exception_object_pointer_name
    Especifica um nome para um ponteiro de objeto de exceção que será criado pela macro.Você pode usar o nome de ponteiro para acessar o objeto de exceção dentro do CATCH bloco.Essa variável é declarada para você.

Comentários

O código de processamento de exceção pode interrogar o objeto de exceção, se apropriado, para obter mais informações sobre a causa específica da exceção.Chamar o THROW_LAST macro para deslocar o processamento para o próximo quadro exceção externa.Fim do tente bloquear com um END_CATCH macro.

Se exception_class é a classe CException, e todos os tipos de exceção serão detectados.Você pode usar o CObject::IsKindOf função de membro para determinar qual exceção específica.A melhor maneira de capturar vários tipos de exceções é usar seqüencial AND_CATCH instruções, cada um com um tipo de exceção diferente.

O ponteiro de objeto de exceção é criado pela macro.Não é necessário declará-lo.

ObservaçãoObservação

O CATCH bloco é definido como um escopo C++ delineado por chaves.Se você declarar variáveis neste escopo, são acessíveis somente dentro desse escopo.Isso também se aplica a exception_object_pointer_name.

Para obter mais informações sobre exceções e o CATCH macro, consulte o artigo exceções.

Exemplo

CFile* pFile = NULL;
// Constructing a CFile object with this override may throw
// a CFile exception and won't throw any other exceptions.
// Calling CString::Format() may throw a CMemoryException,
// so we have a catch block for such exceptions, too. Any
// other exception types this function throws will be
// routed to the calling function.
TRY
{
   pFile = new CFile(_T( "C:\\WINDOWS\\SYSTEM.INI"), 
      CFile::modeRead | CFile::shareDenyNone);
   ULONGLONG dwLength = pFile->GetLength();
   CString str;
   str.Format(_T("Your SYSTEM.INI file is %I64u bytes long.") , dwLength);
   AfxMessageBox(str);
}
CATCH(CFileException, pEx)
{
   // Simply show an error message to the user.
   pEx->ReportError();
}
AND_CATCH(CMemoryException, pEx)
{
   // We can't recover from this memory exception, so we'll
   // just terminate the app without any cleanup. Normally, 
   // an application should do everything it possibly can to
   // clean up properly and not call AfxAbort().
   AfxAbort();
}
END_CATCH
// If an exception occurs in the CFile constructor,
// the language will free the memory allocated by new
// and will not complete the assignment to pFile.
// Thus, our cleanup code needs to test for NULL.
if (pFile != NULL)
{
   pFile->Close();
   delete pFile;
}

Requisitos

Cabeçalho: Afx. h

Consulte também

Referência

TENTE

AND_CATCH

END_CATCH

THROW (MFC)

THROW_LAST

CATCH_ALL

Classe CException

Conceitos

Globais e Macros do MFC