建置命令和屬性的巨集
更新：2010 年 12 月
您可以在專案 [屬性頁] 對話方塊中任何可以接受字串的地方使用這些巨集。 這些巨集不區分大小寫。
若要顯示目前可用的巨集，請按一下屬性名稱右欄中的下拉箭號。 如果 [編輯] 可以使用，請按一下它，然後按一下編輯對話方塊中的 [巨集]。 如需詳細資訊，請參閱屬性頁 (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 檔案。 |
請參閱
其他資源
變更記錄
日期 |
記錄 |
原因 |
|---|---|---|
|
2010 年 12 月 |
描述顯示目前可用巨集的方法。 |
客戶回函。 |
|
2010 年 7 月 |
連結至「項目中繼資料巨集」主題，並且改進巨集標記法原型。 |
內容 Bug 修正。 |