component pragma

控制來源檔案內流覽資訊或相依性資訊的集合。

語法

#pragma component( browser,{ on | off } [ [ ,references, name ] ])
#pragma component( minrebuild, { on | off } )
#pragma component( mintypeinfo, { on | off } )

備註

瀏覽器

您可以開啟或關閉收集功能，而且可以指定要在收集的資訊中忽略的特定名稱。

使用 開啟或關閉可控制從 pragma 向前流覽資訊的集合。 例如：

#pragma component(browser, off)

讓編譯器停止收集瀏覽資訊。

注意

若要開啟使用此 pragma 來收集流覽資訊， 必須先啟用 流覽資訊。

選項 references 可以搭配或不使用 name 引數使用。 使用 references 沒有 名稱的 會開啟或關閉參考收集（不過，仍會繼續收集其他流覽資訊）。 例如：

#pragma component(browser, off, references)

讓編譯器停止收集參考資訊。

搭配名稱使用 references ，並 off 防止名稱的參考 出現在流覽資訊 視窗中。 使用這個語法會忽略您沒有興趣的名稱和類型，並可減少瀏覽資訊檔的大小。 例如：

#pragma component(browser, off, references, DWORD)

會忽略從該點向前指向 DWORD 的參考。 您可以使用 來重新 on 收集對 DWORD 的參考：

#pragma component(browser, on, references, DWORD)

這是繼續收集名稱 參考 的唯一方法;您必須明確開啟您已關閉的任何 名稱 。

若要防止預處理器展開名稱 （例如將 Null 展開為 0），請將引號放在它周圍：

#pragma component(browser, off, references, "NULL")

最小重建

已被 /Gm 取代的 （啟用最小重建） 功能需要編譯器建立及儲存 C++ 類別相依性資訊，這需要磁碟空間。 若要節省磁碟空間，您可以在不需要收集相依性資訊時使用 #pragma component( minrebuild, off ) ，例如，在未變更的標頭檔中。 在未變更類別之後插入 #pragma component( minrebuild, on ) ，以重新開啟相依性集合。

減少類型資訊

選項 mintypeinfo 會減少指定之區域的偵錯資訊。 這項資訊的容量相當可觀，會影響到 .pdb 和 .obj 檔案。 您無法對區域中的 mintypeinfo 類別和結構進行偵錯。 mintypeinfo使用 選項有助於避免下列警告：

LINK : warning LNK4018: too many type indexes in PDB "filename", discarding subsequent type information

如需詳細資訊，請參閱 /Gm [啟用最小重建] 編譯器選項。

另請參閱

Pragma 指示詞和 __pragma 和 _Pragma 關鍵字