CException 类

Microsoft 基础类库中所有异常的基类。

语法

class AFX_NOVTABLE CException : public CObject

成员

公共构造函数

公共方法

备注

因为 CException 是抽象基类，因此无法直接创建 CException 对象；必须创建派生类的对象。 如果需要创建自己的 CException 样式类，请使用上面列出的派生类之一作为模型。 确保派生类也使用 IMPLEMENT_DYNAMIC。

派生类及其说明如下：

这些异常旨在与 THROW、THROW_LAST、try、catch、and_catch 和 end_catch 宏配合使用。 有关异常的详细信息，请参阅异常处理，或参阅异常处理 (MFC) 一文。

若要捕获特定异常，请使用相应的派生类。 若要捕获所有类型的异常，请使用 CException，然后使用 CObject::IsKindOf 来区分 CException派生类。 请注意，CObject::IsKindOf 仅适用于使用 IMPLEMENT_DYNAMIC 宏声明的类，但可充分利用动态类型检查。 你创建的任何 CException 派生类也应使用 IMPLEMENT_DYNAMIC 宏。

可以通过调用 GetErrorMessage 或 ReportError（两个成员函数，适用于 CException 的任何派生类）向用户报告有关异常的详细信息。

如果宏之一捕获了异常，系统会自动删除 CException 对象；你不要自行删除它。 如果使用 catch 关键字捕获异常，系统不会自动删除该异常。 若要详细了解何时删除异常对象，请参阅异常处理 (MFC) 一文。

继承层次结构

CObject

CException

要求

标头：afx.h

CException::CException

此成员函数构造一个 CException 对象。

explicit CException(BOOL bAutoDelete);

参数

b_AutoDelete
如果已在堆上分配 CException 对象的内存，则指定 TRUE。 这将导致在调用 Delete 成员函数来删除异常时删除 CException 对象。 如果 CException 对象位于堆栈上或者是全局对象，则指定 FALSE。 这种情况下，在调用 Delete 成员函数时，不会删除 CException 对象。

备注

通常不需要直接调用此构造函数。 引发异常的函数应创建 CException 派生类的实例并调用其构造函数，或者应使用 MFC 引发函数之一（例如 AfxThrowFileException）来引发预定义类型。 提供本文档只是为了补全。

CException::Delete

此函数查看是否已在堆上创建了 CException 对象，如果答案为是，它会调用对象上的 delete 运算符。

void Delete();

备注

删除 CException 对象时，请使用 Delete 成员函数删除异常。 不要直接使用 delete 运算符，因为 CException 对象可能是全局对象或者已在堆栈上创建。

可以指定是否应在构造对象时删除对象。 有关详细信息，请参阅 CException::CException。

只有在使用 C++ try- catch 机制时，才需调用 Delete。 如果使用的是 MFC 宏 TRY 和 CATCH，则这些宏会自动调用此函数。

示例

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.
// Note that this example performs the same actions as the
// example for CATCH, but uses C++ try/catch syntax instead
// of using the MFC TRY/CATCH macros. This sample must use
// CException::Delete() to delete the exception objects
// before closing the catch block, while the CATCH example
// implicitly performs the deletion via the macros.
try
{
   pFile = new CFile(_T("C:\\WINDOWS\\SYSTEM.INI"),
      CFile::modeRead | CFile::shareDenyNone);
   ULONGLONG ullLength = pFile->GetLength();
   CString str;
   str.Format(_T("Your SYSTEM.INI file is %u bytes long."), ullLength);
   AfxMessageBox(str);
}
catch(CFileException* pEx)
{
   // Simply show an error message to the user.
   pEx->ReportError();
   pEx->Delete();
}
catch(CMemoryException* pEx)
{
   // We can't recover from this memory exception, so we'll
   // just terminate the app without any cleanup. Normally, an
   // an application should do everything it possibly can to
   // clean up properly and _not_ call AfxAbort().
   pEx->Delete();
   AfxAbort();
}
// 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 clean-up code needs to test for NULL.
if (pFile != NULL)
{
   pFile->Close();
   delete pFile;
}

CException::ReportError

调用此成员函数，以向用户报告消息框中的错误文本。

virtual int ReportError(
    UINT nType = MB_OK,
    UINT nMessageID = 0);

参数

nType
指定消息框的样式。 将消息框样式的任意组合应用到框。 如果未指定此参数，则默认值为 MB_OK。

nMessageID
指定在异常对象没有错误消息时要显示的消息的资源 ID（字符串表条目）。 如果为 0，则显示“没有错误消息”消息。

返回值

AfxMessageBox 值；否则为 0（如果没有足够的内存来显示消息框）。 请参阅 AfxMessageBox，了解可能的返回值。

示例

以下是使用 CException::ReportError 的示例。 如需另一个示例，请参阅 CATCH 的示例。

CFile fileInput;
CFileException ex;

// try to open a file for reading.
// The file will certainly not
// exist because there are too many explicit
// directories in the name.

// if the call to Open() fails, ex will be
// initialized with exception
// information.  the call to ex.ReportError() will
// display an appropriate
// error message to the user, such as
// "\Too\Many\Bad\Dirs.DAT contains an
// invalid path."  The error message text will be
// appropriate for the
// file name and error condition.

if (!fileInput.Open(_T("\\Too\\Many\\Bad\\Dirs.DAT"), CFile::modeRead, &ex))
{
  ex.ReportError();
}
else
{
  // the file was opened, so do whatever work
  // with fileInput we were planning...

  fileInput.Close();
}

另请参阅

CObject 类
层次结构图
异常处理