共用方式為


了解使用 Visual Basic 的專案與解決方案

在這篇簡介文章中,我們將探討在 Visual Studio 中建立「解決方案」和「專案」的意義。 解決方案是用來組織一或多個相關程式碼專案的容器,例如類別庫專案和對應的測試專案。 我們會查看專案的屬性以及它可包含的一些檔案。 我們也會建立兩個專案之間的參考。

提示

如果您尚未安裝 Visual Studio,請前往 Visual Studio 下載頁面免費進行安裝。

我們將會從頭建構方案和專案,作為教育練習以了解專案的概念。 在 Visual Studio 的一般使用中,您可能在建立新專案時使用 Visual Studio 所提供的一些各種專案「範本」

注意

在 Visual Studio 中開發應用程式不需要方案和專案。 您也可以只開啟包含程式碼的資料夾,並開始撰寫程式碼、建置和偵錯。 例如,如果您複製 GitHub 存放庫,則它可能不會包含 Visual Studio 專案和方案。 如需詳細資訊,請參閱在 Visual Studio 中不使用專案或方案來開發程式碼

方案和專案

儘管名稱為方案,但其並非「解答」。 解決方案僅是 Visual Studio 用來組織一或多個相關專案的容器。 當您在 Visual Studio 中開啟解決方案時,會自動載入解決方案包含的所有專案。

建立解決方案

我們會建立空白解決方案以開始探索。 在您了解 Visual Studio 之後,可能發現自己不會過於頻繁地建立空白解決方案。 當您建立新的專案時,Visual Studio 會自動建立要儲存專案的方案 (若尚未開啟方案)。

  1. 開啟 Visual Studio。

  2. 在開始視窗中,選擇 [建立新專案]

  3. 在 [建立新專案] 頁面上,於搜尋方塊中輸入空白的解決方案、選取 [空白的解決方案] 範本,然後選擇 [下一步]

    Screenshot showing the Create a new project window with 'blank solution' in the search box and the Blank Solution project template selected.

  4. 將解決方案命名為 QuickSolution,然後選擇 [建立]

    解決方案隨即會出現在 Visual Studio 視窗右側的 [方案總管] 中。 您可能會經常使用方案總管來瀏覽專案的內容。

  1. 開啟 Visual Studio。

  2. 在開始視窗中,選擇 [建立新專案]

  3. 在 [建立新專案] 頁面上,於搜尋方塊中輸入空白的解決方案、選取 [空白的解決方案] 範本,然後選擇 [下一步]

    Screenshot showing the Create a new project window with 'blank solution' in the search box and the Blank Solution project template selected.

  4. 將解決方案命名為 QuickSolution,然後選擇 [建立]

    解決方案隨即會出現在 Visual Studio 視窗右側的 [方案總管] 中。 您可能會經常使用方案總管來瀏覽專案的內容。

新增專案

現在讓我們將第一個專案新增至解決方案。 我們將從空白專案開始,並將需要的項目新增至專案。

  1. 在 [方案總管] 中,從 [方案 'QuickSolution'] 的右鍵功能表或操作功能表中,選擇 [新增]>[新增專案]

    隨即開啟一個對話方塊,表示要 [新增專案]

  2. 在頂端的搜尋方塊中輸入文字空白,然後在 [語言] 底下選取 [Visual Basic]

  3. 選取 [空白專案 (.NET Framework)] 範本,然後選擇 [下一步]

  4. 將專案命名為 QuickDate,然後選擇 [建立]

    名為 QuickDate 的專案隨即出現在 [方案總管] 中該方案的下方。 它目前包含稱為 App.config 的單一檔案。

    注意

    如果您未看到 [空白專案 (.NET Framework)] 範本,您必須安裝 [.NET 桌面開發] 的 Visual Studio「工作負載」。 Visual Studio 會使用工作負載安裝,只安裝您執行之開發類型所需的元件。 建立新專案時安裝新工作負載的簡單方式,就是在顯示 [找不到您要尋找的項目嗎?] 文字底下,選擇 [安裝更多工具與功能] 連結。 Visual Studio Installer 啟動之後,請選擇 [.NET 桌面開發] 工作負載,然後選取 [修改] 按鈕。

    Screenshot showing the Create a new project window with the 'Install more tools and features' link highlighted.

  1. 在 [方案總管] 中,從 [方案 'QuickSolution'] 的右鍵功能表或操作功能表中,選擇 [新增]>[新增專案]

    隨即開啟一個對話方塊,表示要 [新增專案]

  2. 在頂端的搜尋方塊中輸入文字空白,然後在 [所有語言] 下拉式清單中選取 [Visual Basic]

  3. 選取 [空白專案 (.NET Framework)] 範本,然後選擇 [下一步]

  4. 將專案命名為 QuickDate,然後選擇 [建立]

    名為 QuickDate 的專案隨即出現在 [方案總管] 中該方案的下方。 它目前包含稱為 App.config 的單一檔案。

    注意

    如果您未看到 [空白專案 (.NET Framework)] 範本,您必須安裝 [.NET 桌面開發] 的 Visual Studio「工作負載」。 Visual Studio 會使用工作負載安裝,只安裝您執行之開發類型所需的元件。 建立新專案時安裝新工作負載的簡單方式,就是在顯示 [找不到您要尋找的項目嗎?] 文字底下,選擇 [安裝更多工具與功能] 連結。 Visual Studio Installer 啟動之後,請選擇 [.NET 桌面開發] 工作負載,然後選取 [修改] 按鈕。

    Screenshot showing the Create a new project window with the 'Install more tools and features' link highlighted.

將項目新增至專案

我們有空白專案。 請新增程式碼檔案。

  1. 在 [方案總管] 中,從 [QuickDate] 的右鍵功能表或操作功能表中,選擇 [新增]>[新增項目]

    [新增項目] 對話方塊隨即開啟。

  2. 展開 [一般項目],然後選擇 [程式碼]。 在中間窗格中,選擇 [類別] 項目範本。 將類別命名為 Calendar,然後選擇 [新增] 按鈕。

    名為 Calendar.vb 的檔案會新增至專案。 尾端的 .vb 是提供給 Visual Basic 程式碼檔案的副檔名。 此檔案會出現在 [方案總管] 的視覺效果專案階層中,並在編輯器中開啟其內容。

  3. 以下列程式碼取代 Calendar.vb 檔案的內容:

    Class Calendar
        Public Shared Function GetCurrentDate() As Date
            Return DateTime.Now.Date
        End Function
    End Class
    

    Calendar 類別包含單一函式 GetCurrentDate,它會傳回目前日期。

  4. 在 [方案總管] 中按兩下 [我的專案],開啟專案屬性。 在 [應用程式] 索引標籤上,將 [應用程式類型] 變更為 [類別庫]。 需要執行此步驟,才能成功建置專案。

  5. 在 [方案總管] 中,以滑鼠右鍵按一下 [QuickDate],然後選擇 [建置] 來建置專案。 您應該會在 [輸出] 視窗看到成功建置訊息。

新增第二個專案

解決方案通常會包含多個專案,而且這些專案通常會彼此參考。 解決方案中有些專案可能是類別庫、有些是可執行的應用程式,有些可能是單元測試專案或網站。

請將單元測試專案新增至解決方案。 現在我們先從專案範本開始,因此不需要將額外程式碼檔案新增至專案。

  1. 在 [方案總管] 中,從 [方案 'QuickSolution'] 的右鍵功能表或操作功能表中,選擇 [新增]>[新增專案]
  1. 在 [新增專案] 對話方塊的頂端搜尋方塊中輸入文字單元測試,然後在 [語言] 底下選取 [Visual Basic]

  2. 選擇 [單元測試專案 (.NET Framework)] 專案範本,然後選擇 [下一步]

  3. 將專案命名為 QuickTest,然後選擇 [建立]

    第二個專案會新增至方案總管,並在編輯器中開啟名為 UnitTest1.vb 的檔案。

  1. 在 [新增專案] 對話方塊的頂端搜尋方塊中輸入文字單元測試,然後在 [所有語言] 下拉式清單中選取 [Visual Basic]

  2. 選擇 [單元測試專案 (.NET Framework)] 專案範本,然後選擇 [下一步]

  3. 將專案命名為 QuickTest,然後選擇 [建立]

    第二個專案會新增至方案總管,並在編輯器中開啟名為 UnitTest1.vb 的檔案。

新增專案參考

我們將使用新的單元測試專案來測試 QuickDate 專案中的方法,因此必須新增該專案的參考。 該參考會建立兩個專案之間的組建相依性,表示在建置解決方案時會先建置 QuickDate 再建置 QuickTest

  1. 選擇 [QuickTest] 專案中的 [參考] 節點,然後從右鍵功能表或操作功能表中選擇 [新增參考]

    Screenshot showing the context menu for the References node in the QuickTest project, with the 'Add Reference' option selected.

    [參考管理員] 對話方塊隨即開啟。

  2. 在左窗格中,展開 [專案],然後選擇 [解決方案]。 在中間窗格中,選擇 [QuickDate] 旁邊的核取方塊,然後選擇 [確定] 按鈕。

    隨即新增 QuickDate 專案的參考。

  1. 選擇 [QuickTest] 專案中的 [參考] 節點,然後從右鍵功能表或操作功能表中選擇 [新增參考]

    Screenshot showing the context menu for the References node in the QuickTest project, with the 'Add Reference' option selected.

    [參考管理員] 對話方塊隨即開啟。

  2. 在左窗格中,展開 [專案],然後選擇 [解決方案]。 在中間窗格中,選擇 [QuickDate] 旁邊的核取方塊,然後選擇 [確定] 按鈕。

    隨即新增 QuickDate 專案的參考。

新增測試程式碼

  1. 我們現在會將測試程式碼新增至 Visual Basic 程式碼檔案。 以下列程式碼取代 UnitTest1.vb 檔案的內容。

    <TestClass()> Public Class UnitTest1
    
        <TestMethod()> Public Sub TestGetCurrentDate()
            Assert.AreEqual(Date.Now.Date, QuickDate.Calendar.GetCurrentDate())
        End Sub
    
    End Class
    

    您會在一些程式碼下方看到紅色曲線。 我們將修正這個錯誤,方法是將測試專案設為 QuickDate 專案的 friend 組件

  2. 回到 QuickDate 專案,開啟尚未開啟的 Calendar.vb 檔案,並新增下列 Imports 陳述式InternalsVisibleToAttribute 屬性,以解決測試專案中的錯誤。

    Imports System.Runtime.CompilerServices
    
    <Assembly: InternalsVisibleTo("QuickTest")>
    

    程式碼檔應該如下:

    Screenshot showing the code for Calendar.vb in the Visual Basic code editor window, after the Imports statement and Assembly attribute lines have been added.

  1. 我們現在會將測試程式碼新增至 Visual Basic 程式碼檔案。 以下列程式碼取代 UnitTest1.vb 檔案的內容。

    <TestClass()> Public Class UnitTest1
    
        <TestMethod()> Public Sub TestGetCurrentDate()
            Assert.AreEqual(Date.Now.Date, QuickDate.Calendar.GetCurrentDate())
        End Sub
    
    End Class
    

    您會在一些程式碼下方看到紅色曲線。 我們將修正這個錯誤,方法是將測試專案設為 QuickDate 專案的 friend 組件

  2. 回到 QuickDate 專案,開啟尚未開啟的 Calendar.vb 檔案,並新增下列 Imports 陳述式InternalsVisibleToAttribute 屬性,以解決測試專案中的錯誤。

    Imports System.Runtime.CompilerServices
    
    <Assembly: InternalsVisibleTo("QuickTest")>
    

    程式碼檔應該如下:

    Screenshot showing the code for Calendar.vb in the Visual Basic code editor window after the Imports statement and Assembly attribute lines have been added.

專案屬性

Calendar.vb 檔案中包含 InternalsVisibleToAttribute 屬性的行會參考 QuickTest 專案的組件名稱 (檔案名稱)。 組件名稱不一定會與專案名稱相同。 若要尋找專案的組件名稱,請開啟專案屬性。

  1. 在方案總管中,選取 QuickTest 專案。 從右鍵功能表或操作功能表中,選擇 [屬性],或只按 Alt+Enter 鍵。 (您也可以在 [方案總管] 中按兩下 [我的專案]。)

    專案的「屬性頁」會在 [應用程式] 索引標籤上開啟。屬性頁包含專案的各種設定。 請注意,QuickTest 專案的組件名稱確實是 "QuickTest"。 如果您想要變更組件名稱,則可於此處進行變更。 然後,當您建置測試專案時,所產生二進位檔案的名稱會從 QuickTest.dll 變更為您選擇的任何名稱。

    Screenshot showing the Application tab of the property pages for the QuickTest project. The Assembly name field is highlighted and the value is 'QuickTest'.

  2. 探索專案屬性頁的一些其他索引標籤 (例如 [編譯] 和 [設定])。 不同專案類型的這些索引標籤不同。

Calendar.vb 檔案中包含 InternalsVisibleToAttribute 屬性的行會參考 QuickTest 專案的組件名稱 (檔案名稱)。 組件名稱不一定會與專案名稱相同。 若要尋找專案的組件名稱,請開啟專案屬性。

  1. 在方案總管中,選取 QuickTest 專案。 從右鍵功能表或操作功能表中,選擇 [屬性],或只按 Alt+Enter 鍵。 (您也可以在 [方案總管] 中按兩下 [我的專案]。)

    專案的「屬性頁」會在 [應用程式] 索引標籤上開啟。屬性頁包含專案的各種設定。 請注意,QuickTest 專案的組件名稱確實是 "QuickTest"。 如果您想要變更組件名稱,則可於此處進行變更。 然後,當您建置測試專案時,所產生二進位檔案的名稱會從 QuickTest.dll 變更為您選擇的任何名稱。

    Screenshot showing the Application tab of the property pages for the QuickTest project. The Assembly name field is highlighted and the value is 'QuickTest'.

  2. 探索專案屬性頁的一些其他索引標籤 (例如 [編譯] 和 [設定])。 不同專案類型的這些索引標籤不同。

(選擇性) 執行測試

如果您想要確認單元測試是否正常運作,請從功能表列中選擇 [測試]>[執行]>[所有測試]。 稱為 [測試總管] 的視窗隨即開啟,而且您應該會看到 TestGetCurrentDate 測試通過。

Screenshot of the Test Explorer in Visual Studio showing that the TestGetCurrentDate test passed.

提示

如果 [測試總管] 未自動開啟,請從功能表列選擇 [測試]>[Windows]>[測試總管] 開啟它。

如果您想要確認單元測試是否正常運作,請從功能表列中選擇 [測試]>[執行所有測試]。 稱為 [測試總管] 的視窗隨即開啟,而且您應該會看到 TestGetCurrentDate 測試通過。

Screenshot of the Test Explorer in Visual Studio showing that the TestGetCurrentDate test passed.

提示

如果 [測試總管] 未自動開啟,請從功能表列選擇 [測試]>[Windows]>[測試總管] 開啟它。

下一步

如果您想要進一步探索 Visual Studio,請考慮遵循其中一個 Visual Basic 教學課程,來建立應用程式。

另請參閱