Chapter 5: Advanced C# Class Construction Techniques

This chapter rounds out your introduction to the core aspects of the C# language by examining a number of advanced (but extremely useful) syntactic constructs. To begin, you learn how to construct and use an indexer method.

Visual Studio.NET Documentation Support

If the thought of ending up with a raw XML file is a bit anticlimactic, be aware that VS.NET does offer another comment-formatting option. Using the same XML tags you have just examined, you may make use of the "Tools | Build Comment Web Pages..." menu option. When you select this item, you will be asked if you wish to build the entire solution or a specific project within the solution set, as shown in Figure 5-14.



Figure 5-14. Configuration of your HTML-based documentation

The Build Comment Web Pages option will respond by creating a new folder in your project directory that holds a number of images and HTML files built based on your XML documentation. You can now open the main HTML file and view your commented project. For example, check out Figure 5-15:



Figure 5-15. The generated XmlCarDoc online documentation

SOURCE CODE The XmlDocCar project is located under the Chapter 5 subdirectory.