Cアーカイブ例外クラスCArchiveException Class

シリアル化の例外条件を表します。Represents a serialization exception condition

構文Syntax

class CArchiveException : public CException

メンバーMembers

パブリック コンストラクターPublic Constructors

名前Name 説明Description
Cアーカイブ例外:: Cアーカイブ例外CArchiveException::CArchiveException CArchiveException オブジェクトを構築します。Constructs a CArchiveException object.

パブリック データ メンバーPublic Data Members

名前Name 説明Description
Cアーカイブ例外:: m_causeCArchiveException::m_cause 例外の原因を示します。Indicates the exception cause.
Cアーカイブ例外:: m_strFileNameCArchiveException::m_strFileName この例外条件のファイルの名前を指定します。Specifies the name of the file for this exception condition.

解説Remarks

クラスには、 CArchiveException 例外の原因を示すパブリックデータメンバーが含まれています。The CArchiveException class includes a public data member that indicates the cause of the exception.

CArchiveException オブジェクトは、 CArchive メンバー関数内で構築およびスローされます。CArchiveException objects are constructed and thrown inside CArchive member functions. これらのオブジェクトには、 CATCH 式のスコープ内でアクセスできます。You can access these objects within the scope of a CATCH expression. 原因コードは、オペレーティングシステムに依存しません。The cause code is independent of the operating system. 例外処理の詳細については、「 例外処理 (MFC)」を参照してください。For more information about exception processing, see Exception Handling (MFC).

継承階層Inheritance Hierarchy

CObjectCObject

CExceptionCException

CArchiveException

要件Requirements

ヘッダー: afxHeader: afx.h

Cアーカイブ例外:: Cアーカイブ例外CArchiveException::CArchiveException

オブジェクトの CArchiveException 原因 の値を格納して、オブジェクトを構築します。Constructs a CArchiveException object, storing the value of cause in the object.

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

パラメーターParameters

causecause
例外の理由を示す列挙型変数。An enumerated type variable that indicates the reason for the exception. 列挙子の一覧については、「 m_cause データメンバー」を参照してください。For a list of the enumerators, see the m_cause data member.

LpszアーカイブlpszArchiveName
例外を発生させたオブジェクトの名前を含む文字列を指し CArchive ます。Points to a string containing the name of the CArchive object causing the exception.

解説Remarks

CArchiveExceptionヒープ上にオブジェクトを作成し、自分でスローするか、グローバル関数でAfxThrowArchiveExceptionに処理させることができます。You can create a CArchiveException object on the heap and throw it yourself or let the global function AfxThrowArchiveException handle it for you.

このコンストラクターを直接使用しないでください。代わりに、グローバル関数を呼び出し AfxThrowArchiveException ます。Do not use this constructor directly; instead, call the global function AfxThrowArchiveException.

Cアーカイブ例外:: m_causeCArchiveException::m_cause

例外の原因を指定します。Specifies the cause of the exception.

int m_cause;

解説Remarks

このデータメンバーは、型のパブリック変数です intThis data member is a public variable of type int. この値は列挙型によって定義され CArchiveException ます。Its values are defined by a CArchiveException enumerated type. 列挙子とその意味は次のとおりです。The enumerators and their meanings are as follows:

  • CArchiveException::none エラーは発生しませんでした。CArchiveException::none No error occurred.

  • CArchiveException::genericException 指定されていないエラー。CArchiveException::genericException Unspecified error.

  • CArchiveException::readOnly 読み込み用に開いているアーカイブに書き込もうとしました。CArchiveException::readOnly Tried to write into an archive opened for loading.

  • CArchiveException::endOfFile オブジェクトの読み取り中にファイルの終わりに達しました。CArchiveException::endOfFile Reached end of file while reading an object.

  • CArchiveException::writeOnly 保存用に開いているアーカイブから読み取ろうとしました。CArchiveException::writeOnly Tried to read from an archive opened for storing.

  • CArchiveException::badIndex ファイル形式が無効です。CArchiveException::badIndex Invalid file format.

  • CArchiveException::badClass オブジェクトを間違った型のオブジェクトに読み取ろうとしました。CArchiveException::badClass Tried to read an object into an object of the wrong type.

  • CArchiveException::badSchema 異なるバージョンのクラスを使用してオブジェクトを読み取ろうとしました。CArchiveException::badSchema Tried to read an object with a different version of the class.

    注意

    これらの CArchiveException 原因列挙子は、CFileException 原因列挙子とは異なります。These CArchiveException cause enumerators are distinct from the CFileException cause enumerators.

    注意

    CArchiveException::generic は非推奨とされます。CArchiveException::generic is deprecated. 代わりに、genericException を使用してください。Use genericException instead. ジェネリック がアプリケーションで使用されていて、/clr でビルドされている場合、解読が容易ではない構文エラーが発生します。If generic is used in an application and built with /clr, there will be syntax errors that are not easy to decipher.

Cアーカイブ例外:: m_strFileNameCArchiveException::m_strFileName

この例外条件のファイルの名前を指定します。Specifies the name of the file for this exception condition.

CString m_strFileName;

関連項目See also

CException クラスCException Class
階層図Hierarchy Chart
CArchive クラスCArchive Class
AfxThrowArchiveExceptionAfxThrowArchiveException
例外処理Exception Processing