CArchiveException 類別

發行項
08/04/2024

表示串行化例外狀況條件

語法

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
例外狀況處理

共用方式為