共用方式為

Windows Form 設計工具錯誤頁面

若 Windows Forms 設計工具因為您的程式碼、第三方元件或其他原因而無法載入，將顯示錯誤頁面而非設計工具。 這個錯誤頁面不一定代表設計師有錯誤。 錯誤可能在後端程式碼檔案中的某個位置。 錯誤會出現在可折疊的黃色列中，並顯示連結以跳至字碼頁中錯誤的位置。

Visual Studio 中的設計工具錯誤索引標籤，指出按鈕的事件遺失。

錯誤視窗

錯誤視窗是由各種不同部分所組成。

  • 黃色條

    系統會針對每個錯誤建立黃色可摺疊列，並依描述分組。 代表的條狀顯示了編譯器錯誤，導致設計工具無法載入屬性。 它包含這些詳細資料：

    • 錯誤所在的檔案。
    • 檔案中發生錯誤的欄和行。
    • 錯誤碼。
    • 錯誤的描述。
    • 直接導航到錯誤的連結。

  • 此錯誤的實例。

    當展開黃色錯誤欄時，會列出每一個錯誤的例項。 許多錯誤類型包括確切的位置，格式如下：[專案名稱]<>[表單名稱]<> [行：][行號]<>[資料行：][資料行號碼]<>。 如果錯誤與呼叫堆疊相關聯，您可以點選 [顯示呼叫堆疊] 連結進行查看。 檢查呼叫堆疊可進一步協助您解決錯誤。

    這很重要

    錯誤的元素可能會根據您使用的程式碼語言而有所不同。

  • 協助解決此錯誤

    如果有錯誤的說明文章可供使用，請選取 MSDN 說明連結以直接瀏覽至說明頁面。

  • 此錯誤的相關論壇文章

    選取 [在 MSDN 論壇中搜尋與此錯誤相關的文章] 連結以瀏覽至 Microsoft Developer Network 論壇。 您可能會想要在 Microsoft Q&A 或 StackOverflow 論壇上搜尋或詢問問題。

首先嘗試什麼

您通常可以透過清理並重建專案或解決方案來排除錯誤。

  1. 尋找 方案總管視窗。
  2. 在解決方案或專案上按右鍵，然後選取 [清除]。
  3. 在解決方案或專案上按右鍵，然後選取 [重建]。

您也可以嘗試從專案資料夾刪除 bin 和 obj 資料夾。 這可能會清除暫存檔案，或造成還原動作發生，並修正不正確的相依性。

使用以下的部分來分類常見的設計階段錯誤。

常見的設計階段錯誤

本節列出您可能會遇到的一些錯誤。

在目前的內容中，「<名稱>」此名稱不存在。

在設計檔案所參考的後置程式碼檔案中刪除或重新命名事件處理常式時，您最常會看到此錯誤。 開啟 <表單>.designer<language>程式碼檔案，並從表單或控制項中刪除事件處理常式。

「<識別碼名稱>」不是有效的識別碼

此錯誤表示欄位、方法、事件或物件未正確命名。

「<名稱>」已存在「<專案名稱>」內

您已為已存在專案中的繼承表單指定名稱。 若要更正此錯誤，請為繼承表單指定唯一的名稱。

「<[工具箱] 索引標籤名稱>」不是工具箱類別

第三方設計師試圖存取工具箱中不存在的索引標籤。 請連絡元件廠商。

尚未安裝所需的語言剖析器

Visual Studio 嘗試載入與該檔案類型相關聯的設計器，但未能成功載入。 這很可能是因為在安裝期間發生錯誤。 請連絡您所使用之語言的廠商進行修正。

缺少用於生成和解析原始碼的必要服務

此錯誤是因第三方元件的問題。 請連絡元件廠商。

嘗試建立「<物件名稱>」的執行個體時發生例外狀況

第三方設計工具已要求 Visual Studio 建立物件，但物件引發錯誤。 請連絡元件廠商。

另一個編輯器在不相容模式下開啟「<文件名稱>」

如果您嘗試開啟已在其他編輯器中開啟的檔案，則會引發此錯誤。 顯示已開啟檔案的編輯器。 若要更正此錯誤，請關閉已開啟檔案的編輯器，然後再試一次。

另一個編輯器已對「<文件名稱>」進行變更

關閉並重新開啟設計工具，以使變更生效。 通常，Visual Studio 會在進行變更之後自動重新載入設計師。 然而，其他設計工具，例如第三方元件設計工具，可能不支援重新載入行為。 在此情況下，Visual Studio 會提示您手動關閉並重新開啟設計工具。

另一個編輯器在不相容模式下開啟檔案

此訊息類似於「另一個編輯器在不相容模式下開啟『<文件名稱>』」，但 Visual Studio 無法判斷檔案名稱。 若要更正此錯誤，請關閉已開啟檔案的編輯器，然後再試一次。

陣列等級過高 "<rank in array>"

Visual Studio 僅支援設計工具剖析的程式碼區塊中的單一維度陣列。 多維度陣列在此區域之外有效。

「<組件名稱>」組件無法開啟

當您嘗試開啟無法開啟的檔案時，會出現此錯誤訊息。 請確認檔案存在且為有效的組件。

不正確的元素類型。 此序列化程式必須有類型為「<類型名稱>」的元素

此錯誤是因第三方元件的問題。 請連絡元件廠商。

目前無法存取 Visual Studio [工具箱]

Visual Studio 嘗試訪問無法使用的工具箱。 如果您看到此錯誤，請使用 [回報問題] 來記錄問題。

因為是唯讀的，無法將事件處理常式繫結至「<事件名稱>」事件

當您嘗試將事件連結至繼承自基底類別的控制項時，通常會發生此錯誤。 如果控制項的成員變數是私人的，Visual Studio 就無法將事件連結至該方法。 私人繼承的控制項不能有額外的事件繫結至這些控制項。

因為要求的元件不是設計容器的成員，所以無法建立要求元件的方法名稱

Visual Studio 已嘗試在設計工具中沒有成員變數的元件新增事件處理常式。 請連絡元件廠商。

無法將此物件命名為「<名稱>」，因為它已經命名為「<名稱>」

這個錯誤是 Visual Studio 序列化程式的內部錯誤。 其表示序列化程式已嘗試為物件命名兩次，但不受支援。 如果您看到此錯誤，請使用 [回報問題] 來記錄問題。

無法移除或摧毀繼承的「<元件名稱>」元件

繼承的控制項屬於其繼承類別的擁有權。 繼承的控制項變更必須在控制項的來源類別中進行。 因此，您無法重新命名或摧毀它。

「<[工具箱] 索引標籤名稱>」之類別沒有「<類別名稱>」類別的工具

設計工具嘗試參考特定 [工具箱] 索引標籤上的類別，但該類別不存在。 請連絡元件廠商。

「<類型名稱>」類別沒有相符的建構函式

第三方設計工具已要求 Visual Studio 在不存在的建構函式中建立具有特定參數的物件。 請連絡元件廠商。

無法產生「<屬性名稱>」屬性的程式碼

這個錯誤是錯誤的泛型包裝函式。 此訊息隨附的錯誤字串會提供關於錯誤訊息的更多詳細資料，並提供更具體的說明文章連結。 若要更正此錯誤，請解決附加至此錯誤之錯誤訊息中指定的錯誤。

「<元件名稱>」元件未呼叫其建構函式中的 Container.Add()

此訊息與您已載入或放置在表單上的元件中的錯誤相關。 這表明元件未將自身新增至其容器控制項（是否是另一個控制項還是表單）。 設計者會繼續工作，但元件在執行階段可能會出現問題。

若要更正錯誤，請連絡元件廠商。 或者，如果是您所建立的元件，請在元件的建構函式中呼叫 IContainer.Add 方法。

元件名稱不可為空白

當您嘗試將元件重新命名為空白值時，則會出現此錯誤。

無法存取「<變數名稱>」變數，因為它還沒有初始化

此錯誤可能會因為兩種情況而發生。 第三方元件廠商有其已散發的控制項或元件的問題，或您撰寫的程式碼在元件之間具有遞迴相依性。

若要更正此錯誤，請確保您的程式碼沒有遞迴相依性。 如果沒有這類問題，請記下錯誤訊息的確切文字，並連絡元件廠商。

找不到「<類型名稱>」類型

錯誤訊息：找不到「<類型名稱>」類型。 請確保已參考包含此類型的元件。 如果此類型是您開發專案的一部分，請確保已成功組建專案。」

發生此錯誤是因為找不到參考。 請確保參照錯誤訊息中指出的類型，並且也參考該類型所需的所有組件。 通常，問題在於尚未組建解決方案中的控制項。 若要組建，請從 [組建] 功能表中選取 [組建解決方案]。 否則，如果已組建控制項，請從 [方案總管] 中的 [參考] 資料夾或 [相依性] 資料夾的右鍵選單中手動加入參考。

無法載入「<類型名稱>」類型

Visual Studio 嘗試連接事件處理方法，但找不到該方法的一或多個參數類型。 這個錯誤通常是由遺失參考所造成。 若要更正此錯誤，請將包含類型的參考新增至專案，然後再試一次。

找不到繼承元件的專案項目範本

Visual Studio 中的繼承表單範本不可用。 如果您看到此錯誤，請使用 [回報問題] 來記錄問題。

委派類別「<類別名稱>」沒有叫用方法。 此類別是否為委派

Visual Studio 已嘗試建立事件處理常式，但事件類型發生錯誤。 如果事件是由不符合 CLS 規範的語言所建立，則會發生此錯誤。 請連絡元件廠商。

重複宣告成員「<成員名稱>」

發生此錯誤，是因為成員變數已宣告兩次 (例如，程式碼中已宣告兩個名為 Button1 的控制項)。 名稱在繼承的表單中必須是唯一的。 此外，名稱不能僅為大小寫的不同。

從資源檔案中讀取文化 '<文化名稱>' 的資源時發生錯誤

如果專案中有錯誤的 .resx 檔案，則可能會出現此錯誤。

若要更正此錯誤：

  1. 選取 [方案總管] 中的 [顯示所有檔案] 按鈕以檢視與解決方案相關聯的 .resx 檔案。
  2. 在 XML 編輯器中載入 .resx 檔案，方法是在 .resx 檔案上按右鍵，然後選擇 [開啟]。
  3. 手動編輯 .resx 檔案以解決錯誤。

預設文化「<文化名稱>」的資源檔讀取錯誤

如果專案中的預設文化特性中有錯誤的 .resx 檔案，則可能會出現此錯誤。

若要更正此錯誤：

  1. 選取 [方案總管] 中的 [顯示所有檔案] 按鈕以檢視與解決方案相關聯的 .resx 檔案。
  2. 在 XML 編輯器中載入 .resx 檔案，方法是在 .resx 檔案上按右鍵，然後選擇 [開啟]。
  3. 手動編輯 .resx 檔案以解決錯誤。

剖析「<方法名稱>」方法時失敗

錯誤訊息：「剖析『<方法名稱>』方法時失敗。 剖析器回報下列錯誤：『<錯誤字串>』。 請查看 [工作清單] 中是否有潛在錯誤。」

這是在解析期間發生問題的一般錯誤訊息。 這些錯誤通常是因為語法錯誤所造成。 如需與錯誤相關的特定訊息，請參閱 [工作清單]。

無效的元件名稱：「<元件名稱>」

您已嘗試將元件重新命名為對於該語言無效的值。 若要更正此錯誤，請為元件命名，使其符合該語言的命名規則。

「<類型名稱>」類型是由相同檔案中的數個部分類別所組成

當您使用部分關鍵字在多個檔案中定義類別時，每個檔案中只能有一個部分定義。

若要更正此錯誤，請從檔案中移除類別的所有部分定義 (僅保留一個部分定義)。

找不到「<組件名稱>」組件

此錯誤類似於「找不到類型『<類型名稱>』」，但此錯誤通常是因為中繼資料屬性而發生。 若要更正此錯誤，請檢查所有屬性所使用的組件是否已被參考。

組件名稱「<組件名稱>」無效

元件已要求特定組件，但元件所提供的名稱不是有效的組件名稱。 請連絡元件廠商。

無法設計基底類別「<類別名稱>」

Visual Studio 已載入類別，但無法設計類別，因為類別的實作工具未提供設計工具。 如果類別支援設計工具，請確保沒有任何問題會造成在設計工具中顯示它時出現問題，例如編譯器錯誤。 此外，請確保類別的所有參考皆正確，並且所有類別名稱拼寫正確。 否則，如果類別無法設計，請在 [程式碼檢視] 中編輯它。

無法載入「<類別名稱>」基底類別

類別未在專案中參考，因此 Visual Studio 無法載入它。 若要更正此錯誤，請在專案中新增類別的參考，然後關閉並重新開啟 Windows Form 設計工具視窗。

在此版本的 Visual Studio 中無法設計類別「<類別名稱>」

此控制項或元件的設計工具不支援與 Visual Studio 相同的類型。 請連絡元件廠商。

此類別名稱不是此語言的有效識別碼

使用者所建立的原始程式碼具有對於所使用語言無效的類別名稱。 若要更正此錯誤，請命名該類別，使其符合語言需求。

因為元件包含對「<參考名稱>」的循環參考，因此無法新增

您無法將控制項或元件新增至其本身。 另一個可能發生這種情況的狀況是，如果表單 (例如 Form1) 的 InitializeComponent 方法中有程式碼，則會建立 Form1 的另一個執行個體。

目前無法修改設計者

當編輯器中的檔案標示為唯讀時，則會出現此錯誤。 請確保檔案未標示為唯讀，且應用程式未執行。

無法顯示此檔案的設計師，因為其中的所有類別都無法設計

當 Visual Studio 找不到符合設計工具需求的基底類別時，則會出現此錯誤。 表單和控制項必須衍生自支援設計工具的基底類別。 如果您從繼承的表單或控制項衍生，請確保專案已組建。

未安裝「<類別名稱>」基底類別的設計工具

Visual Studio 無法載入該類別的設計工具。 如果您看到此錯誤，請使用 [回報問題] 來記錄問題。

設計師必須建立「<類型名稱>」類型的實例，但由於該類型被宣告為抽象類型，因此無法建立。

發生此錯誤是因為傳遞至設計工具之物件的基底類別為抽象，這是不允許的。

無法將檔案載入設計工具

這個檔案的基底類別不支援任何設計工具。 因應措施是使用 [程式碼檢視] 來處理檔案。 以滑鼠右鍵按一下 [方案總管] 中的檔案，然後選擇 [檢視程式碼]。

這個檔案所使用的語言不支援必要的程式碼剖析及產生服務

錯誤訊息：「這個檔案所使用的語言不支援必要的程式碼剖析及產生服務。 請確保您開啟的檔案是專案的成員，然後再次嘗試開啟檔案。」

此錯誤很可能是因為開啟不支援設計工具之專案中的檔案所造成。

未正確實作語言剖析器類別「<類別名稱>」

錯誤訊息：「語言剖析器類別 '<類別名稱>' 未正確實作。」 請連絡廠商以取得更新的剖析器模組。」

使用中的語言已註冊了一個設計師類別，但該類別並非從正確的基底類別派生出來。 請連絡您所使用之語言的廠商。

其他物件已經使用名稱「<名稱>」

這是 Visual Studio 序列化程式的內部錯誤。 如果您看到此錯誤，請使用 [回報問題] 來記錄問題。

「<物件名稱>」物件並未實作 IComponent 介面

Visual Studio 已嘗試建立元件，但建立的物件不會實作 IComponent 介面。 請連絡元件廠商進行修正。

「<物件名稱>」物件已傳回「<屬性名稱>」屬性為 null，但這是不允許的

有一些 .NET 屬性應該一律傳回物件。 例如，表單的 [控制項] 集合應該一律會傳回物件，即使其中沒有任何控制項也一樣。

若要更正此錯誤，請確保錯誤中指定的屬性不是 null。

序列化資料物件不是適當的類型

序列化程式提供的資料物件不是適合目前使用的序列化程式類型的實例。 請連絡元件廠商。

必須有「<服務名稱>」服務，但無法找到

Visual Studio 所需的服務無法使用。 如果您嘗試載入不支援該設計工具的專案，請改用 [程式碼編輯器] 進行變更。 否則，如果您看到此錯誤，請使用 [回報問題] 來記錄問題。

服務執行個體必須從「<介面名稱>」衍生或實作

此錯誤表示元件或元件設計工具已呼叫 AddService 方法，其需要介面和物件，但指定的物件不會實作指定的介面。 請連絡元件廠商。

無法修改程式碼視窗中的文字

當 Visual Studio 因磁碟空間或記憶體問題而無法編輯檔案，或檔案標示為唯讀時，則會出現此錯誤。

工具箱列舉物件只可一次擷取一個項目

如果您看到此錯誤，請使用 [回報問題] 來記錄問題。

無法從 [工具箱] 擷取「<元件名稱>」 的 [工具箱] 項目

涉及的元件在 Visual Studio 存取它時拋出例外狀況。 請連絡元件廠商。

無法從 [工具箱] 擷取「<工具箱項目名稱>」的 [工具箱] 項目

如果 [工具箱] 項目內的資料已損毀，或元件的版本已變更，則會出現此錯誤。 請嘗試從 [工具箱] 中移除項目，然後再次將其加回。

找不到「<類型名稱>」類型

載入設計工具時，Visual Studio 無法找到類型。 請確保已引用包含特定類型的元件。 如果組件是目前開發專案的一部分，請確保專案已被建置。

只能從主應用程式的執行緒中呼叫類型解析服務

Visual Studio 已嘗試從錯誤的執行緒存取必要的資源。 當用於建立設計工具的程式碼從主應用程式執行緒以外的執行緒呼叫類型解析服務時，會顯示此錯誤。 若要更正此錯誤，請從正確的執行緒呼叫服務，或連絡元件廠商。

「<變數名稱>」變數尚未宣告或從未指派

原始程式碼中參考到一個變數，例如 Button1，但該變數尚未被宣告或指派。 如果尚未指派變數，此訊息會顯示為警告，而不是錯誤。

「<功能表命令名稱>」功能表命令已經有命令處理常式

如果第三方設計工具將已有處理常式的命令新增至命令資料表中，則會出現此錯誤。 請連絡元件廠商。

已經有名為「<元件名稱>」的元件

錯誤訊息：「已經有名為『<元件名稱>』的元件。 元件必須具有唯一的名稱，且名稱不得區分大小寫。 名稱也無法與繼承的類別中任何元件的名稱衝突。」

當 [屬性] 視窗中的元件名稱變更時，就會出現此錯誤訊息。 若要更正此錯誤，請確保所有元件名稱都是唯一的、不區分大小寫，也不會與繼承類別中任何元件的名稱衝突。

已經有為格式「<格式名稱>」登錄的工具箱項目創建者

有一個第三方元件對工具箱索引標籤上的某個項目進行回呼，但是該項目已經包含了一個回呼。 請連絡元件廠商。

此語言引擎不支援用來載入設計工具的 CodeModel

此訊息類似於「此檔案的語言不支援必要的程式碼剖析和產生服務」，但此訊息涉及內部註冊問題。 如果您看到此錯誤，請使用 [回報問題] 來記錄問題。

「<類型名稱>」類型沒有「<參數類型名稱>」類型參數的建構函式

Visual Studio 找不到具有相符參數的建構函式。 這個錯誤可能是由於向建構函式提供的類型不是所需類型的結果。 例如，點數建構函式可能需要兩個整數。 如果您提供浮點數類型，就會引發此錯誤。

若要更正此錯誤，請使用不同的建構函式，或明確轉換參數類型，使其與建構函式提供的類型相符。

無法將「<參考名稱>」之參考新增至目前的應用程式

Visual Studio 無法新增參考。 若要更正此錯誤，請檢查是否已經參考了不同版本的參考資料。

無法檢出目前的檔案

當您變更目前簽入原始程式碼控制項的檔案時，就會出現此錯誤。 Visual Studio 通常會顯示 [檔案簽出] 對話方塊，以便使用者可以簽出檔案。 這次檔案未簽出，可能是因為在檔案簽出時發生合併衝突。 若要更正此錯誤，請確保檔案未鎖定，然後嘗試手動簽出檔案。

找不到名為「<[選項] 對話方塊索引標籤名稱>」的頁面

當元件設計工具使用不存在的名稱要求從 [選項] 對話方塊存取頁面時，就會出現此錯誤。 請連絡元件廠商。

在「<選項對話框標籤名稱>」頁面上找不到屬性「<屬性名稱>」

當元件設計工具要求從「選項」對話方塊存取頁面上的特定值，但該值不存在時，就會引發此錯誤。 請連絡元件廠商。

Visual Studio 無法開啟這個檔案的設計工具，因為它裡面的類別不會從能以視覺化方式設計的類別繼承

Visual Studio 已載入類別，但無法載入該類別的設計師。 Visual Studio 要求設計工具在檔案中使用第一個類別。 若要更正此錯誤，請移動類別程式碼，使其為檔案中的第一個類別，然後再次載入設計工具。

Visual Studio 無法儲存或載入「<類型名稱>」類型的執行個體

這是第三方元件的問題。 請連絡元件廠商。

Visual Studio 無法在設計檢視中開啟「<文件名稱>」

此錯誤表示專案的語言不支援設計工具，當您嘗試在 [開啟檔案] 對話方塊或從 [方案總管] 開啟檔案時，會出現此錯誤。 請改為在 [程式碼檢視] 中編輯檔案。

Visual Studio 找不到類型為「<類型名稱>」的類別設計器

Visual Studio 已載入類別，但無法設計類別。 相反地，可以透過以滑鼠右鍵按一下類別並選擇 [檢視程式碼] 以在 [程式碼檢視] 中編輯類別。