Code comments that you add in the InitializeComponent method are lost when you add a control in Visual Studio .NET or in Visual Studio 2005

In Microsoft Visual Studio .NET or in Microsoft Visual Studio 2005, when you create a Microsoft Windows Application project, you can add code comments in the InitializeComponent method. However, if you add a control to the Windows Form later, the code comments that you added previously are lost.

When you add a control to the Windows Form, the Windows Forms Designer automatically regenerates the code for the InitializeComponent method. Therefore, the code comments that you added are lost.

The code that the Windows Forms Designer automatically generates contains comments that appear before the InitializeComponent method. These comments state that you must not use the code editor to modify the contents of the InitializeComponent method.

The following automatically generated code comments appear before the InitializeComponent method in Windows Form class files:

• Visual C# .NET or Visual C# 2005

  /// Required method for Designer support - do not modify
  /// the contents of this method with the code editor.

• Visual Basic .NET or Visual Basic 2005

  'NOTE: The following procedure is required by the Windows Form Designer
  'It can be modified using the Windows Form Designer.
  'Do not modify it using the code editor.

  Note In these code comments, "Windows Form Designer" is a misspelling of "Windows Forms Designer."

Steps to reproduce the behavior

1. Start Visual Studio .NET or Visual Studio 2005.
2. Create a Windows Application project that is named MyApplication. By default, a Windows Form that is named Form1 is created.
3. Add a Button control to the Form1 form.
4. Add some code comments in the InitializeComponent method of the Form1 class file.
5. Click the Form1[Design] tab.
6. Add a Label control to the Form1 form.
7. Switch to the code view of the Form1 form.
   
   Notice that your code comments have been lost.

For more information about the Windows Forms Designer, visit the following Microsoft Developer Network (MSDN) Web site: