Skip to main content

managing-winforms-designer-code

Governs WinForms Designer-generated code structure and InitializeComponent patterns. Use when writing or reviewing .Designer.cs files, fixing "Designer file cannot be loaded" errors, resolving Designer round-trip issues, validating control instantiation in InitializeComponent, implementing proper Dispose(bool disposing) pattern with components.Dispose(), working with IContainer and components field, troubleshooting Designer serialization failures, organizing Designer code vs application logic separation, or understanding what code belongs in InitializeComponent vs elsewhere. Also triggers for "InitializeComponent", ".Designer.cs file", "Designer cannot load", "components.Dispose", "IContainer field", "Designer compatibility", "Designer round-trip", and "Form Designer errors".

Informações da origem

Repositório
microsoft/upgrade-agent-plugins
Última atividade na origem
10 de setembro de 2026 às 04:23
Idioma detectado do SKILL.md
inglês
Estrelas
41
Forks
9

Opções de instalação

Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.

Revise os arquivos de origem

Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.

Explorador de arquivos
2 arquivos

Exibindo SKILL.md

SKILL.md
Instruções da origem · Visualização somente leitura
name
managing-winforms-designer-code
description
Governs WinForms Designer-generated code structure and InitializeComponent patterns. Use when writing or reviewing .Designer.cs files, fixing "Designer file cannot be loaded" errors, resolving Designer round-trip issues, validating control instantiation in InitializeComponent, implementing proper Dispose(bool disposing) pattern with components.Dispose(), working with IContainer and components field, troubleshooting Designer serialization failures, organizing Designer code vs application logic separation, or understanding what code belongs in InitializeComponent vs elsewhere. Also triggers for "InitializeComponent", ".Designer.cs file", "Designer cannot load", "components.Dispose", "IContainer field", "Designer compatibility", "Designer round-trip", and "Form Designer errors".
metadata
{"discovery":"lazy","traits":"(.NET|CSharp|VisualBasic|DotNetCore) & WindowsForms"}
# WinForms Designer Code Rules The WinForms Designer generates serialization code, not regular C# code. Understanding and following these rules is CRITICAL for Designer compatibility. **All WinForms Forms and UserControls should be Designer-compatible** — these rules are not optional guidance but mandatory constraints for any code that the Designer must be able to round-trip (read, modify, and re-serialize). ## When to Use This Skill Use this skill when: - Generating the code which makes up a Form or a UserControl in WinForms. - Writing or modifying `.Designer.cs` or `.Designer.vb` files - Creating user controls that need Designer support - Reviewing Designer-generated code - Reviewing whether WinForms Forms/UserControls are "designed according to standard", "not designed properly", or similar; pair this with `managing-winforms-high-dpi-layout` so both Designer serialization and human/layout/DPI quality are checked. - Debugging Designer-related issues - Migrating forms between .NET Framework and .NET - Migrating VB6 Code to either Visual Basic (.NET) or C# WinForms Projects. **IMPORTANT:** Other skills (layout, rendering, data binding, MVVM) describe *what* to build. This skill defines *how* the Designer code-behind file must be structured. When those skills show control configuration, the actual property assignments belong in `InitializeComponent` following the rules below. ## Related Skills - [building-winforms-applications](../building-winforms-applications/SKILL.md) - [managing-winforms-data-binding](../managing-winforms-data-binding/SKILL.md) - [managing-winforms-mvvm](../managing-winforms-mvvm/SKILL.md) - [managing-winforms-high-dpi-layout](../managing-winforms-high-dpi-layout/SKILL.md) - [creating-winforms-custom-controls](../creating-winforms-custom-controls/SKILL.md) ## Detailed Guidance Read [Detailed guide](ref/detailed-guide.md) for comprehensive patterns, examples, and troubleshooting. ## Workflow 1. Confirm the scenario matches the triggers in this skill. 2. Apply the baseline pattern from this file. 3. Read [Detailed guide](ref/detailed-guide.md) for advanced or edge-case handling. 4. Validate changes with an actual build and runtime check.
Ver no GitHub