逐步解說:編譯以 Visual Studio 中 CLR 為目標的 C++/CLI 程式

藉由使用 C++/CLI,您可以建立使用 .NET 類別和原生 C++ 類型的 C++ 程式。 C++/CLI 適用于主控台應用程式和包裝原生 C++ 程式碼的 DLL,並使其可從 .NET 程式存取。 若要根據 .NET 建立 Windows 使用者介面,請使用 C# 或 Visual Basic。

針對此程式,您可以輸入自己的 C++ 程式,或使用其中一個範例程式。 我們在此程序中使用的範例程式會建立名為 textfile.txt 的文字檔,並將它儲存至專案目錄。

必要條件

  • 對 C++ 語言基本知識的了解。
  • 在 Visual Studio 2017 和更新版本中,C++/CLI 支援是選擇性元件。 若要安裝,請從 Windows [開始] 功能表開啟 Visual Studio 安裝程式 。 請確定已核取 [ 使用 C++ 進行桌面開發] 圖格,並在 [選用 元件] 區段中,檢查 C++/CLI 支援

建立新專案

下列步驟會依您使用的 Visual Studio 版本而略有不同。 若要查看您慣用 Visual Studio 版本的檔,請使用 版本 選取器控制項。 其位於此頁面目錄頂端。

在 Visual Studio 中建立 C++/CLI 專案

  1. 方案總管 中,以滑鼠右鍵按一下頂端,以開啟 [建立新專案 ] 對話方塊。

  2. 在對話方塊頂端,在搜尋方塊中輸入 CLR ,然後 從結果清單中選擇 CLR 空白專案 (.NET Framework)。

  3. 選擇 [建立] 按鈕以建立專案。

在 Visual Studio 2017 中建立 C++/CLI 專案

  1. 建立新專案。 在 [檔案] 功能表上,指向 [開新檔案] ,然後按一下 [專案]

  2. 從 Visual C++ 專案類型,按一下 [CLR],然後按一下 [CLR 空專案]

  3. 鍵入專案名稱。 根據預設,包含專案的方案與新專案具有相同的名稱,但您可以輸入不同的名稱。 如果您想要,也可以輸入不同的專案位置。

  4. 按一下 [確定] 建立新專案。

在 Visual Studio 2015 中建立 C++/CLI 專案

  1. 建立新專案。 在 [檔案] 功能表上,指向 [開新檔案] ,然後按一下 [專案]

  2. 從 Visual C++ 專案類型,按一下 [CLR],然後按一下 [CLR 空專案]

  3. 鍵入專案名稱。 根據預設,包含專案的方案與新專案具有相同的名稱,但您可以輸入不同的名稱。 如果您想要,也可以輸入不同的專案位置。

  4. 按一下 [確定] 建立新專案。

新增原始程式檔

  1. 如果未顯示 [方案總管],請按一下 [檢視] 功能表上的 [方案總管]

  2. 新增原始程式檔至專案:

    • 以滑鼠右鍵按一下 [方案總管] 中的來源檔案資料夾,指向 [新增],然後按一下 [新增項目]

    • 按一下 [C++ 檔 (.cpp)] 並鍵入檔案名稱,然後按一下 [新增]

    .cpp 檔案會出現在 [方案總管]來源檔案資料夾中;當您在該檔案中鍵入所需程式碼時,該處會顯示索引標籤式視窗。

  3. 按一下 Visual Studio 中新建立的索引標籤,然後鍵入有效的 Visual C++ 程式,或複製並貼上其中一個範例程式。

    例如,您可以使用如何:寫入文字檔 (C++/CLI) 範例程式 (位於《程式設計指南》的檔案處理和 I/O節點中)。

    如果您使用範例程式,注意您會在建立 .NET 物件時使用 gcnew 關鍵字而不是 new,而且 gcnew 會傳回控制代碼 (^) 而不是指標 (*):

    StreamWriter^ sw = gcnew StreamWriter(fileName);

    如需 C++/CLI 語法的詳細資訊,請參閱 執行時間平臺的元件延伸模組

  4. 在 [建置] 功能表上,按一下 [建置方案]。

    [輸出] 視窗會顯示編譯進度的相關資訊,例如組建記錄檔的位置,以及指出組建狀態的訊息。

    如果您進行變更,然後執行程式而不進行建置,對話方塊可能會指出專案已過期。 如果您想要 Visual Studio 一律使用目前版本的檔案,而不是每次建置應用程式都提示您,請先選取此對話方塊上的核取方塊,再按一下 [確定]

  5. 在 [偵錯] 功能表上,按一下 [啟動但不偵錯]

  6. 如果您使用範例程式,當您執行程式時,就會顯示命令視窗指出已建立文字檔。

    textfile.txt 文字檔現在位於專案目錄中。 您可以使用 [記事本] 開啟此檔案。

    注意

    選擇空白的 CLR 專案範本時,會自動設定 /clr 編譯器選項。 若要進行確認,請以滑鼠右鍵按一下 [方案總管] 中的專案並按一下 [屬性],然後在 [組態屬性] 的 [一般] 節點中,核取 [Common Language Runtime 支援]

另請參閱

C++ 語言參考
專案和建置系統