Partial classes and XML documentation comments


Partial classes and XML documentation comments

At work, we use CodeSmith to generate persistent business objects from existing database schema. Our templates create partial classes; this allows us to add functionality while preserving the ability to regenerate the original classes at any time. The CodeSmith templates pull metadata from the tables to create XML documentation comments.

So what happens if we add class documentation comments to the other half of the partial class?

Here’s the weird part: IntelliSense appears to pull the comment from whichever file was modified most recently. You don’t even have to rebuild to test it - it’s immediate.

It might be nice if it merged the comments, but perhaps that’s too much to ask.

Your Host:
Copyright © 2000-2013 by William Sorensen. All rights reserved.