CArchive::MapObject

呼叫此成員函式上不會真的序列化為檔案，但是，請可供子物件中參考的物件在對應中。

void MapObject(
   const CObject* pOb 
);

參數

• pOb
  要儲存的物件具有固定的指標。

備註

例如，您可能無法還原資料，不過，您會序列化是文件一部分的項目。 藉由呼叫 MapObject，因此您可以將這些項目或子物件，參考文件。 此外，序列化的子項目可以還原序列化其 m_pDocument 返回指標。

當您儲存至 CArchive 物件時，就會載入您可以呼叫 MapObject 。 MapObject 加入 CArchive 物件維護的內部資料結構的指定物件在序列化和還原序列化 (Deserialization) 期間，，但不同的 ReadObject 和 WriteObject, 該物件不會序列化。

範例

//MyDocument.h
class CMyDocument : public CDocument
{
public:
   DECLARE_SERIAL(CMyDocument)

   CObList m_listOfSubItems;

   virtual void Serialize(CArchive& ar);
};

//MyDocument.cpp
IMPLEMENT_SERIAL(CMyDocument, CDocument, 1)

void CMyDocument::Serialize(CArchive& ar)
{
   CDocument::Serialize(ar);

   if (ar.IsStoring())
   {
      // TODO: add storing code here
   }
   else
   {
      // TODO: add loading code here
   }

   ar.MapObject(this);  

   //serialize the subitems in the document;
   //they will be able to serialize their m_pDoc
   //back pointer
   m_listOfSubItems.Serialize(ar);
}

//SubItem.h
class CSubItem : public CObject
{
   DECLARE_SERIAL(CSubItem)
   CSubItem() : m_i(0) {};

public:
   CSubItem(CMyDocument * pDoc)
     { m_pDoc = pDoc; }

   // back pointer to owning document
   CMyDocument* m_pDoc; 
   WORD m_i; // other item data

   virtual void Serialize(CArchive& ar);
};

//SubItem.cpp
IMPLEMENT_SERIAL(CSubItem, CObject, 1);

void CSubItem::Serialize(CArchive& ar)

{
   if (ar.IsStoring())
   {
      // will serialize a reference 
      // to the "mapped" document pointer
      ar << (CObject *)m_pDoc;
      ar << m_i;
   }
   else
   {
      // Will load a reference to
      // the "mapped" document pointer
      ar >> (CObject *&) m_pDoc;
      ar >> m_i;
   }
}

需求

Header: afx.h

請參閱

參考

CArchive 類別

階層架構圖

CArchive::ReadObject

CArchive::WriteObject