This print for content only-size & color not accurate 7" X 9-1/4" / casebound / malloy

Figure 5-12.

XML comments are viewable via IntelliSense.

C H A P T E R   5  

■

D E F I N I N G   E N C A P S U L AT E D   C L A S S  T Y P E S

178

8849CH05.qxd  10/22/07  1:34 PM  Page 178

---

Generating the XML File

In any case, once you have documented your code with XML comments, the next step is to generate

a corresponding *.xml file based on the XML data. If you are building your C# programs using the

command-line compiler (csc.exe), the /doc flag is used to generate a specified *.xml file based on

your XML code comments:

csc /doc:XmlCarDoc.xml *.cs

Visual Studio 2008 projects allow you to specify the name of an XML documentation file using

the Generate XML documentation file check box option found on the Build tab of the Properties

window (see Figure 5-13).

Figure 5-13.

Generating an XML code comment file via Visual Studio 2008

Once you have enabled this behavior, the compiler will place the generated *.xml file within

your project’s \bin\Debug folder. You can verify this for yourself by clicking the Show All Files but-

ton on the Solution Explorer, generating the result in Figure 5-14.

Figure 5-14.

Locating the generated XML documentation file

C H A P T E R   5  

■

D E F I N I N G   E N C A P S U L AT E D   C L A S S  T Y P E S

179

8849CH05.qxd  10/22/07  1:34 PM  Page 179

---