共用方式為


CArchiveException 類別

表示串行化例外狀況條件

語法

class CArchiveException : public CException

成員

公用建構函式

名稱 描述
CArchiveException::CArchiveException 建構 CArchiveException 物件。

公用資料成員

名稱 描述
CArchiveException::m_cause 指出例外狀況原因。
CArchiveException::m_strFileName 指定這個例外狀況條件的檔名。

備註

類別 CArchiveException 包含指出例外狀況原因的公用數據成員。

CArchiveException物件會在 CArchive 成員函式內建構和擲回。 您可以在 CATCH 表達式的範圍內存取這些物件。 原因碼與操作系統無關。 如需例外狀況處理的詳細資訊,請參閱例外狀況處理(MFC)。

繼承階層架構

CObject

CException

CArchiveException

需求

標頭: afx.h

CArchiveException::CArchiveException

CArchiveException建構 物件,將原因的值儲存在物件中。

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

參數

cause
列舉型別變數,指出例外狀況的原因。 如需列舉值的清單,請參閱 m_cause 數據成員。

lpszArchiveName
指向包含造成例外狀況之物件名稱的 CArchive 字串。

備註

您可以在堆積上建立 CArchiveException 物件,並自行擲回物件,或讓全域函 式 AfxThrowArchiveException 為您處理它。

請勿直接使用此建構函式;請改為呼叫全域函式 AfxThrowArchiveException

CArchiveException::m_cause

指定例外狀況的原因。

int m_cause;

備註

此數據成員是類型的 int公用變數。 其值是由 CArchiveException 列舉型別所定義。 列舉程式及其意義如下:

  • CArchiveException::none 未發生錯誤。

  • CArchiveException::genericException 未指定的錯誤。

  • CArchiveException::readOnly 嘗試寫入開啟以供載入的封存。

  • CArchiveException::endOfFile 讀取物件時已到達檔尾。

  • CArchiveException::writeOnly 嘗試從開啟以供儲存的封存讀取。

  • CArchiveException::badIndex 無效的檔案格式。

  • CArchiveException::badClass 嘗試將物件讀入錯誤類型的物件。

  • CArchiveException::badSchema 嘗試讀取具有不同類別版本的物件。

    注意

    這些 CArchiveException 原因列舉程式不同於 CFileException 原因列舉程式。

    注意

    CArchiveException::generic 已被取代。 請改用 genericException。 如果在 應用程式中使用泛型 ,並使用 /clr 建置,則語法錯誤並不容易譯碼。

CArchiveException::m_strFileName

指定這個例外狀況條件的檔名。

CString m_strFileName;

另請參閱

CException 類別
階層架構圖表
CArchive 類別
AfxThrowArchiveException
例外狀況處理