使用 CArchive <<>> 运算符

CArchive 提供 << 和 >> 运算符,用于将简单的数据类型以及 CObject 写入文件中或者从文件中读取。

通过存档将对象存储在文件中

  1. 以下示例演示如何通过存档将对象存储在文件中:

    CArchive ar(&theFile, CArchive::store);
    WORD wEmployeeID = 78;
    ar << wEmployeeID;
    

从以前存储在文件中的值加载对象

  1. 以下示例演示如何从以前存储在文件中的值加载对象:

    CArchive ar(&theFile, CArchive::load);
    WORD wEmployeeID;
    ar >> wEmployeeID;
    

通常,你会通过 CObject 派生类的 Serialize 函数中的存档存储数据并将数据加载到文件,以及从文件加载数据,这些函数必须是使用 DECLARE_SERIALIZE 宏声明的。 对 CArchive 对象的引用将传递给你的 Serialize 函数。 调用 CArchive 对象的 IsLoading 函数以确定是否已调用 Serialize 函数从文件加载数据或将数据存储到文件中。

可序列化的 CObject 派生类的 Serialize 函数通常具有以下形式:

void CSerializableObj::Serialize(CArchive &archive)
{
   // call base class function first
   // base class is CObject in this case
   CObject::Serialize(archive);

   // now do the stuff for our specific class
   if (archive.IsStoring())
   {
      // TODO:  add storing code here
   }
   else
   {
      // TODO:  add storing code here
   }
}

上面的代码模板与 AppWizard 为文档(从 CDocument 派生的类)的 Serialize 函数创建的模板完全相同。 此代码模板可帮助你编写更易于查看的代码,因为存储代码和加载代码应始终并行,如以下示例所示:

void CEmployee::Serialize(CArchive &archive)
{
   // call base class function first
   // base class is CObject in this case
   CObject::Serialize(archive);

   // now do the stuff for our specific class
   if (archive.IsStoring())
      archive << m_strName << m_wAge;
   else
      archive >> m_strName >> m_wAge;
}

库将 CArchive<<>> 运算符定义为第一个操作数,将以下数据类型和类的类型定义为第二个操作数:

BYTE
CObject*
COleCurrency
COleDateTime
COleDateTimeSpan

COleVariant
CString
CTimeCTimeSpan
Double

DWORD
Float
Int
LONG

POINTCPoint
RECTCRect
SIZECSize
WORD

注意

要通过存档来存储和加载 CObject,需要进行额外考量。 有关详细信息,请参阅通过存档存储和加载 CObject

CArchive<<>> 运算符始终返回对 CArchive 对象的引用,该对象是第一个操作数。 这使你可以链接运算符,如下所示:

archive << m_strName << m_wAge;

另请参阅

序列化:对象的序列化