建置命令和屬性的巨集
您可以在專案 [屬性頁] 對話方塊中任何可以接受字串的地方使用這些巨集。這些巨集不區分大小寫。
若要顯示目前可用的巨集,請按一下屬性名稱右欄中的下拉箭號。如果 [編輯] 可以使用,請按一下它,然後按一下編輯對話方塊中的 [巨集]。如需詳細資訊,請參閱屬性頁 (C++) 的Specifying User-Defined Values一節。
標記為「已取代」的巨集無法再使用,或者已由同等項目中繼資料巨集 (%(name)) 取代。標記為「已取代;已移轉」的巨集也被取代。此外,如果包含巨集的專案移轉自 Visual Studio 2008,則 Visual Studio 會將該巨集轉換成同等的 Visual Studio 2010 巨集。
巨集 |
描述 |
---|---|
$(RemoteMachine) |
設定為 [偵錯] 屬性頁上的 Remote Machine 屬性值。如需詳細資訊,請參閱變更 C/C++ 偵錯組態的專案設定。 |
$(Configuration) |
目前專案組態的名稱 (例如 "Debug")。 |
$(Platform) |
目前專案平台的名稱 (例如 "Win32")。 |
$(ParentName) |
(已取代。) 包含此專案項目的項目名稱。這將會是上層資料夾名稱或專案名稱。 |
$(RootNameSpace) |
包含應用程式的命名空間 (如果有的話)。 |
$(IntDir) |
相對於專案目錄的中繼檔案指定目錄路徑。此路徑應具有尾端斜線。這將解析為 Intermediate Directory 屬性的值。 |
$(OutDir) |
相對於專案目錄的輸出檔目錄路徑。此路徑應具有尾端斜線。這將解析為 Output Directory 屬性的值。 |
$(DevEnvDir) |
Visual Studio 2010 的安裝目錄 (定義為磁碟機 + 路徑),尾端加上反斜線 '\'。 |
$(InputDir) |
(已取代;已移轉。) 輸入檔的目錄 (定義為磁碟機 + 路徑);包括後面的反斜線 '\'。如果專案就是輸入,那麼這個巨集就相當於 $(ProjectDir)。 |
$(InputPath) |
(已取代;已移轉。) 輸入檔的絕對路徑名稱 (定義為磁碟機 + 路徑 + 主檔名 + 副檔名)。如果專案就是輸入,那麼這個巨集就相當於 $(ProjectPath)。 |
$(InputName) |
(已取代;已移轉。) 輸入檔的主檔名。如果專案就是輸入,那麼這個巨集就相當於 $(ProjectName)。 |
$(InputFileName) |
(已取代;已移轉。) 輸入檔的檔名 (定義為主檔名 + 副檔名)。如果專案就是輸入,那麼這個巨集就相當於 $(ProjectFileName)。 |
$(InputExt) |
(已取代;已移轉。) 輸入檔的副檔名。在副檔名之前包括一個 '.'。如果專案就是輸入,那麼這個巨集就相當於 $(ProjectExt)。 |
$(ProjectDir) |
專案的目錄 (定義為磁碟機 + 路徑),包括後面的反斜線 '\'。 |
$(ProjectPath) |
專案的絕對路徑名稱 (定義為磁碟機 + 路徑 + 主檔名 + 副檔名)。 |
$(ProjectName) |
專案的主檔名。 |
$(ProjectFileName) |
專案的檔名 (定義為主檔名 + 副檔名)。 |
$(ProjectExt) |
專案檔的副檔名。在副檔名之前包括一個 '.'。 |
$(SolutionDir) |
方案的目錄 (定義為磁碟機 + 路徑);包括後面的反斜線 '\'。 |
$(SolutionPath) |
方案的絕對路徑名稱 (定義為磁碟機 + 路徑 + 主檔名 + 副檔名)。 |
$(SolutionName) |
方案的主檔名。 |
$(SolutionFileName) |
方案的檔名 (定義為主檔名 + 副檔名)。 |
$(SolutionExt) |
方案的副檔名。在副檔名之前包括一個 '.'。 |
$(TargetDir) |
建置的主要輸出檔目錄 (定義為磁碟機 + 路徑);包括後面的反斜線 '\'。 |
$(TargetPath) |
建置主要輸出檔的絕對路徑名稱 (定義為磁碟機 + 路徑 + 主檔名 + 副檔名)。 |
$(TargetName) |
建置主要輸出檔的主檔名。 |
$(TargetFileName) |
建置主要輸出檔的檔名 (定義為主檔名 + 副檔名)。 |
$(TargetExt) |
建置主要輸出檔的副檔名。在副檔名之前包括一個 '.'。 |
$(VSInstallDir) |
安裝 Visual Studio 2010 的目錄。 這個屬性包含目標 Visual Studio 的版本,其可能與主機 Visual Studio 的版本不同。例如,使用 $(PlatformToolset) = v90 建置時,$(VSInstallDir) 包含 Visual Studio 2008 的安裝路徑。 |
$(VCInstallDir) |
安裝 Visual C++ 2010 的目錄。 這個屬性包含目標 Visual C++ 的版本,其可能與主機 Visual Studio 的版本不同。例如,使用 $(PlatformToolset) = v90 建置時,$(VCInstallDir) 包含 Visual C++ 2008 的安裝路徑。 |
$(FrameworkDir) |
安裝 .NET Framework 的目錄。 |
$(FrameworkVersion) |
Visual Studio 所使用的 .NET Framework 版本。與 $(FrameworkDir) 結合,代表 Visual Studio 所使用之 .NET Framework 版本的完整路徑。 |
$(FrameworkSDKDir) |
安裝 .NET Framework 的目錄。.NET Framework 可能已隨 Visual Studio 2010 安裝或已單獨安裝。 |
$(WebDeployPath) |
從專案輸出所屬的 Web 部署根目錄之相對路徑。傳回和 RelativePath 一樣的值。 |
$(WebDeployRoot) |
<localhost> 位置的絕對路徑。例如 c:\inetpub\wwwroot。 |
$(SafeParentName) |
(已取代。) 符合有效名稱格式的緊鄰上層之名稱。例如,表單是 .resx 檔的上層。 |
$(SafeInputName) |
(已取代。) 檔案的名稱 (做為有效的類別名稱),不包含副檔名。 |
$(SafeRootNamespace) |
(已取代。) 專案精靈即將加入程式碼的命名空間之名稱。這個命名空間名稱將只包含有效的 C++ 識別項所允許使用的字元。 |
$(FxCopDir) |
fxcop.cmd 檔案的路徑。並不是所有 Visual C++ 版本都有安裝 fxcop.cmd 檔案。 |