Skip to content

Commit

Permalink
Update error window troubleshooting (#1812)
Browse files Browse the repository at this point in the history
* update error window troubleshooting

* Apply suggestions from code review

Co-authored-by: Genevieve Warren <[email protected]>

* Update dotnet-desktop-guide/net/winforms/controls-design/designer-errors.md

Co-authored-by: Genevieve Warren <[email protected]>

* Update dotnet-desktop-guide/net/winforms/controls-design/designer-errors.md

Co-authored-by: Genevieve Warren <[email protected]>

---------

Co-authored-by: Genevieve Warren <[email protected]>
  • Loading branch information
adegeo and gewarren authored Apr 22, 2024
1 parent 85fb4ff commit 75682b3
Showing 1 changed file with 34 additions and 18 deletions.
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Design-time errors
description: Learn about some of the common errors that occur when the Windows Forms Designer fails to load.
title: Design-time error troubleshooting
description: Learn about some of the common errors that occur when the Windows Forms Designer fails to load. This article might help you troubleshoot those errors.
ms.date: 07/19/2023
ms.topic: troubleshooting
f1_keywords:
Expand All @@ -17,30 +17,46 @@ If the Windows Forms Designer fails to load due to an error in your code, in a t

:::image type="content" source="media/designer-errors/vs-designer-error-message.png" alt-text="A designer error tab in Visual Studio that says that the event for a button is missing.":::

## Yellow bar
## Error window

The yellow collapsible bar is created for every error, grouped by description. The bar describes the compiler error preventing the designer from loading property. It includes these details:
The error window is made up of various parts.

- The file error resides in.
- The column and row in the file where the error occurs.
- An error code.
- A description of the error.
- A link to navigate directly to the error.
- Yellow bar

## Instances of this error
The yellow collapsible bar is created for every error, grouped by description. The bar describes the compiler error preventing the designer from loading property. It includes these details:

When the yellow error bar is expanded, each instance of the error is listed. Many error types include an exact location in the following format: _\<project name>_ _\<form name>_ Line:_\<line number>_ Column:_\<column number>_. If a call stack is associated with the error, you can select the **Show Call Stack** link to see it. Examining the call stack may further help you resolve the error.
- The file the error resides in.
- The column and row in the file where the error occurs.
- An error code.
- A description of the error.
- A link to navigate directly to the error.

> [!IMPORTANT]
> The elements of an error may vary based on the code language you're using.
- Instances of this error

## Help with this error
When the yellow error bar is expanded, each instance of the error is listed. Many error types include an exact location in the following format: _\<project name>_ _\<form name>_ Line:_\<line number>_ Column:_\<column number>_. If a call stack is associated with the error, you can select the **Show Call Stack** link to see it. Examining the call stack might further help you resolve the error.

If a help article for the error is available, select the **MSDN Help** link to navigate directly to the help page.
> [!IMPORTANT]
> The elements of an error might vary based on the code language you're using.
## Forum posts about this error
- Help with this error

Select the **Search the MSDN Forums for posts related to this error** link to navigate to the old Microsoft Developer Network forums. You may want to search or ask a question on the [Microsoft Q&A](/answers/tags/21/windows-forms) or [StackOverflow](https://stackoverflow.com/questions/tagged/winforms) forums
If a help article for the error is available, select the **MSDN Help** link to navigate directly to the help page.

- Forum posts about this error

Select the **Search the MSDN Forums for posts related to this error** link to navigate to the old Microsoft Developer Network forums. You might want to search or ask a question on the [Microsoft Q&A](/answers/tags/21/windows-forms) or [StackOverflow](https://stackoverflow.com/questions/tagged/winforms) forums.

## What to try first

You can often clear an error by cleaning and rebuilding the project or solution.

01. Find the **Solution Explorer** window.
01. Right-click on the solution or project, and select **Clean**.
01. Right-click on the solution or project, and select **Rebuild**.

You can also try to delete the _bin_ and _obj_ folders from the project folder. This might clear a temporary file or cause a **restore** action to happen, fixing a bad dependency.

Use the following section to triage common design-time errors.

## Common design-time errors

Expand Down Expand Up @@ -135,7 +151,7 @@ You've specified a name for an inherited form that already exists in the project

### '\<Toolbox tab name>' is not a toolbox category

A third-party designer has tried to access a tab on the Toolbox that doesn't exist. Contact the component vendor.
A third-party designer tried to access a tab on the Toolbox that doesn't exist. Contact the component vendor.

### A requested language parser is not installed

Expand Down

0 comments on commit 75682b3

Please sign in to comment.