Share via


建立程式說明:使用註解

更新:2007 年 11 月

在本課程中,您將學習如何在程式的程式碼中建立註解。

組成程式的程式碼可能會很難閱讀及了解,特別是如果程式碼原本不是您所撰寫的。您可以透過使用「註解」,為自己或其他的程式碼使用者建立筆記。

註解是在 [程式碼編輯器] 中的文字項目,而且執行程式時,Visual Basic 編譯器會加以忽略。因此,您可以為自己撰寫筆記,說明程式中某個特定區段所執行的工作,或是提醒自己完成未完成的程式設計工作。

您是以 ' 字元開始一行來建立註解。下列範例示範如何建立註解。

' This is a comment. WOW!

您也可以在行末加入註解,同樣也是使用 ' 字元開始。要為個別程式碼行提供註解經常都是這樣做,如以下範例所示。

MsgBox("Hello World!") ' This line causes a message box to appear.

跟單行註解一樣,程式會忽略該行上 ' 字元之後的任何文字。

使用註解進行偵錯

註解的另一個常見用法是:在為程式進行偵錯時,暫時阻止一行程式碼執行。例如,假設您有一行程式碼,可顯示訊息方塊。

MsgBox("Hello World!")

如果您要在不顯示該訊息方塊下執行程式,而不要將它永久刪除,您可以使用註解字元 ('),暫時隱藏,不讓程式看見,如下所示。

' MsgBox("Hello World!")

由於 ' 字元之後的任何文字都會加以忽略,程式會在不執行該行下執行程式。您可以稍後再移除 ' 字元,如此就會顯示訊息方塊。

試試看!

若要插入註解

  1. 在 [檔案] 功能表上,選取 [新增專案]。

  2. 在 [新增專案] 對話方塊的 [範本] 窗格中,按一下 [Windows 應用程式]。

  3. 在 [名稱] 方塊中,輸入 Comments,再按 [確定]。

    會開啟新的 Windows Form 專案。

  4. 按兩下這份表單,開啟 [程式碼編輯器]。

  5. 在 Form1_Load 事件處理常式中,輸入下列程式碼。

    ' This code will cause two message boxes to appear
    MsgBox("This is Message Box 1") ' Display Message Box 1
    MsgBox("This is Message Box 2") ' Display Message Box 2
    
  6. 請按 F5 執行程式。

    程式啟動時,兩個訊息方塊中各個都會輪流顯示。

  7. 在 [偵錯] 功能表上,選擇 [停止偵錯],以結束程式。

  8. 在 [程式碼編輯器] 中,加入註解字元 (') 至第一個訊息方塊行,讓它顯示如下。

    ' MsgBox("This is MessageBox 1") ' Ignore Message Box 1
    
  9. 請按 F5 執行程式。

    請注意,這時程式會忽略第一個訊息方塊行,而只顯示第二個訊息方塊。

後續步驟

在本課程中,您學到如何使用註解,在程式碼中建立說明,並暫時取消個別的程式碼行。偵錯課程到此告一段落。在下一組課程中,您將學習如何使用資料庫,為程式儲存及擷取資訊。

下一個課程:管理您的記錄:使用程式中的資料

請參閱

概念

程式碼中的註解

其他資源

何處發生錯誤?透過偵錯尋找和修正錯誤