針對控制項和元件撰寫進行疑難排解

發行項
10/19/2023

本主題列出開發元件和控制項時出現的下列常見問題：

無法將控制項新增至工具箱
無法針對 Windows Forms 使用者控制項或元件進行偵錯
事件在繼承的控制項或元件中引發兩次
設計階段錯誤：「無法建立元件 '元件名稱'」
STAThreadAttribute
元件圖示不會出現在工具箱中

無法將控制項新增至工具箱

如果您想要將您在另一個專案中建立的自訂控制項或協力廠商控制項新增至 [工具箱]，您必須手動進行。如果目前專案包含您的控制項或元件，它應該會自動出現在 [工具箱]。如需詳細資訊，請參閱逐步解說：自動將自訂元件填入工具箱。

將控制項新增至工具箱

以滑鼠右鍵按一下 [工具箱]，然後從捷徑功能表選取 [選擇項目]。
在 [選擇工具箱項目] 對話方塊中，新增元件：
- 如果您想要新增 .NET Framework 元件或控制項，請按一下 [.NET Framework 元件] 索引標籤。
  
  -或-
- 如果您想要新增 COM 元件或 ActiveX 控制項，請按一下 [COM 元件] 索引標籤。
如果您的控制項列在對話方塊中，確認它已選取，然後按一下 [確定]。

控制項隨即新增至 [工具箱]。
如果您的控制項未列在對話方塊中，請執行下列作業︰
1. 按一下 [ 瀏覽 ] 按鈕。
2. 瀏覽至包含 .dll 檔案 (包含您的控制項) 的資料夾。
3. 選取 .dll 檔案，然後按一下 [開啟]。
  
  您的控制項會出現在對話方塊中。
4. 確認已選取您的控制項，然後按一下 [確定]。
  
  您的控制項隨即新增至 [工具箱]。

無法針對 Windows Forms 使用者控制項或元件進行偵錯

如果您的控制項衍生自 UserControl 類別，您可以使用測試容器偵錯其執行時間行為。如需詳細資訊，請參閱如何：測試 UserControl 的執行階段行為。

其他自訂控制項和元件不是獨立的專案。它們必須由 Windows Forms 專案之類的應用程式裝載。若要針對控制項或元件進行偵錯，您必須將它新增至 Windows Forms 專案。

針對控制項或元件進行偵錯

按一下 [建置] 功能表上的 [建置方案] 以建置解決方案。
從 [檔案]功能表，選擇 [新增]，然後選擇 [新增專案]，以將測試專案新增至您的應用程式。
在 [加入新的專案] 對話方塊中，針對專案型別選擇 [Windows 應用程式]。
在 [方案總管] 中，以滑鼠右鍵按一下新專案的 [參考] 節點。在捷徑功能表上，按一下 [加入參考] 以將參考新增至包含控制項或元件的專案。
在測試專案中建立您的控制項或元件的執行個體。如果您的元件位於 [工具箱]，您可以將它拖曳至設計工具介面，或者您可以程式設計方式建立執行個體，如下列程式碼範例所示。
```
Dim Component1 As New MyNeatComponent()
```
```
MyNeatComponent Component1 = new MyNeatComponent();
```
您現在可以如同往常一般針對您的控制項或元件進行偵錯。

如需偵錯的詳細資訊，請參閱在 Visual Studio 中偵錯和逐步解說︰在設計階段針對自訂 Windows Forms 控制項進行偵錯。

事件在繼承的控制項或元件中引發兩次

這可能是因為重複的 Handles 子句。如需詳細資訊，請參閱 Visual Basic 中的繼承事件處理常式疑難排解。

設計階段錯誤：「無法建立元件 '元件名稱'」

您的元件或控制項必須提供沒有參數的無參數建構函式。當設計環境建立元件或控制項的執行個體時，它不會嘗試提供任何參數給採用參數的建構函式多載。

STAThreadAttribute

會 STAThreadAttribute 通知 Common Language Runtime （CLR） Windows Forms 使用單一執行緒 Apartment 模型。如果您未將此屬性套用至 Windows Forms 應用程式的 Main 方法，您可能會發現非預期的行為。例如，背景影像可能不會針對之類的 ListView 控制項顯示。某些控制項可能也需要此屬性，才能有正確的 AutoComplete 和拖放行為。

元件圖示不會出現在工具箱中

當您使用 ToolboxBitmapAttribute 將圖示與自訂群組件產生關聯時，點陣圖不會出現在 [工具箱] 中供自動產生的元件使用。若要查看點陣圖，請使用 [選擇工具箱項目] 對話方塊，重新載入控制項。如需詳細資訊，請參閱如何：為控制項提供工具箱點陣圖。