使用 AFX_EXT_CLASS 匯出和匯入

發行項
02/28/2013

擴充 DLL 會使用 AFX_EXT_CLASS 巨集來匯出類別；連結至擴充 DLL 的可執行檔則會使用巨集來匯入類別。使用 AFX_EXT_CLASS 巨集，用來建置擴充 DLL 的相同標頭檔便可以用在連結至該 DLL 的可執行檔。

在您的 DLL 的標頭檔中，依照下列方式將 AFX_EXT_CLASS 關鍵字加入至類別宣告中：

class AFX_EXT_CLASS CMyClass : public CDocument
{
// <body of class>
};

這個巨集會在前置處理器符號 _AFXDLL 和 _AFXEXT 已定義時，由 MFC 定義成 __declspec(dllexport)。但是會在已定義 _AFXDLL 卻沒有定義 _AFXEXT 時，定義成 __declspec(dllimport)。當已定義時，前置處理器符號 _AFXDLL 便會指示出目標可執行檔 (DLL 或應用程式) 已經使用 MFC 的共用版本。當 _AFXDLL 和 _AFXEXT 都已定義時，該巨集便會指示，該目標可執行檔是一個擴充 DLL。

因為從擴充 DLL 匯出時 AFX_EXT_CLASS 是定義成 __declspec(dllexport)，所以您不需要在 .def 檔中為該類別的符號放置裝飾名稱就可以匯出整個類別。 MFC DLLHUSK 範例便用了這個方法。

雖然在這個方法中您不需要為類別建立 .def 檔和所有的裝飾名稱，但是建立 .def 檔卻是較有效率的方式，因為可以依序數匯出名稱。若要使用 .def 檔來匯出，請將下列程式碼置於標頭檔的開頭和結尾：

#undef AFX_DATA
#define AFX_DATA AFX_EXT_DATA
// <body of your header file>
#undef AFX_DATA
#define AFX_DATA

警告

匯出內嵌 (Inline) 函式時要特別小心，因為它們可能會產生版本衝突。內嵌函式會展開至應用程式碼；因此，如果稍後您重寫函式，除非應用程式本身重新編譯，否則並不會將其更新通常 DLL 函式可以更新，而無須重建使用它們的應用程式。

匯出類別中的個別成員

有時您可能想要匯出類別的個別成員。例如，如果您正在匯出 CDialog 衍生類別，您可能只需要匯出建構函式和 DoModal 呼叫。您可以在需要匯出的個別成員上使用 AFX_EXT_CLASS。

例如：

class CExampleDialog : public CDialog
{
public:
   AFX_EXT_CLASS CExampleDialog();
   AFX_EXT_CLASS int DoModal();
   ...
   // rest of class definition
   ...
};

因為您不再匯出類別的所有成員，所以可能會因 MFC 巨集的使用方式而碰到其他問題。有幾個 MFC 的 Helper 巨集實際上會宣告或定義資料成員。因此，這些資料成員也必須從您的 DLL 匯出。

例如，建置擴充 DLL 時，DECLARE_DYNAMIC 巨集會定義如下：

#define DECLARE_DYNAMIC(class_name) \
protected: \
   static CRuntimeClass* PASCAL _GetBaseClass(); \
public: \
   static AFX_DATA CRuntimeClass class##class_name; \
   virtual CRuntimeClass* GetRuntimeClass() const; \

從 static AFX_DATA 開始的這行程式碼是在您的類別內部宣告一個靜態物件。若要從用戶端可執行檔正確地匯出類別並存取執行階段資訊，您必須匯出這個靜態物件。因為靜態物件已經用修飾詞 AFX_DATA 宣告，所以您在建置 DLL 時只需要將 AFX_DATA 定義成 __declspec(dllexport)，而在建立用戶端可執行檔時定義為 __declspec(dllimport)。因為 AFX_EXT_CLASS 已經以這種方式定義，您只需要將 AFX_DATA 重新定義成與類別定義周圍 AFX_EXT_CLASS 相同的定義。

例如：

#undef  AFX_DATA
#define AFX_DATA AFX_EXT_CLASS

class CExampleView : public CView
{
   DECLARE_DYNAMIC()
   // ... class definition ...
};

#undef  AFX_DATA
#define AFX_DATA

因為 MFC 一定會在其巨集內部所定義的資料項目上使用 AFX_DATA 符號，所以這項技巧可用於所有這一類的案例。例如，它可以用於 DECLARE_MESSAGE_MAP。

注意事項
如果您是匯出整個類別而不是類別中選取的成員，則靜態資料成員會自動匯出。

共用方式為

使用 AFX_EXT_CLASS 匯出和匯入

匯出類別中的個別成員

您想要怎麼做？

您還想知道關於哪些方面的詳細資訊？

請參閱

概念

其他資源