Visual Studio and .NET Framework Home
VB.NET Projects require "Generate XML documentation file" to be checked to allow developers to use the VS Feature to auto generate the XML code comment tags.
7/27/2009 9:17:47 AM
User(s) can reproduce this bug
VB.NET Projects require the Project settings: "Generate XML documentation file" to be checked to allow developers to use the VS Feature to auto generate the XML Doc tags.
C# does not require the project settings to create XML Comments.
Not generating XML doc file should not prevent a developer from creating the XML Comment tags.
Visual Studio Team System 2008
Windows XP Professional
Operating System Language
Steps to Reproduce
Create a VB.NET project.
Un-check "Generate XML documentation file" in project settings.
Try to create XML Comment tags using the " ''' " and hit enter.
No tags will be created.
No XML Comment tags created.
XML Comment tags should be created regardless of the "Generate XML documentation file" value.
TAP Code (if applicable)
You can indicate your satisfaction with how Microsoft handled this issue by completing this quick
3 question survey
to post a comment.
Please enter a comment.
Sindre Røbekk Hagerup
on 5/8/2012 at 12:58 AM
Any news on this issue?
on 11/12/2009 at 11:26 AM
C# seems to have an added feature for the editor; I can't imagine it would be that hard to add for VB.
XML Documentation Comments
Generate XML Documentation comments for ///
on 8/4/2009 at 6:52 AM
Is there a work around, to make it behave as it should like it does for c#?
on 7/28/2009 at 8:53 PM
Why does it behave differently for c# projects?
on 7/28/2009 at 4:46 PM
Thanks very much for taking the time to provide this feedback. The current behavior of the "Generate XML Documentation File" option, while unintuitive, is actually by design. The primary is for performance. When the option is unchecked, the VB background compiler does not produce internal parse trees for the XML doc comments, which can positively influence the background compiler's performance. Because the parse trees are not created, the automatic XML doc comment generation is disabled in the editor because, without the parse trees, the VB IDE can't show IntelliSense in the XML doc comments.
All of that said, I completely agree that this is unintuitive and not really the best design. We should fix it. Unfortunately, we won't have time to change this for Visual Studio 2010. I am resolving this as postponed to ensure that we consider this for a future release of Visual Studio.
Please feel free to contact me directly at email@example.com if you have further comments or suggestions.
Visual Basic IDE Program Manager
on 7/27/2009 at 7:52 PM
Thanks for your feedback.
We are rerouting this issue to the appropriate group within the Visual Studio Product Team for triage and resolution. These specialized experts will follow-up with your issue.
to post a workaround.
Please enter a workaround.
on 1/19/2011 at 2:23 AM
Also posted here:http://stackoverflow.com/questions/1088837/
1) In your project properties ensure that Generate XML documention file is checked.
2) Click the Build Events button
3) Into the Post-build event command line box enter the command
Now after each build it will remove the XML comment file.
Note: For some reason if it exists from a previous build it will not delete it so manually delete it the first time.
© 2014 Microsoft