Understanding XML Comments

XML comments are not new in Visual Basic 2015; they were first natively introduced with Visual Basic 2005. (In versions prior to 2005, XML comments were possible only via third-party add-ins.) Visual Basic 2015 brings some improvements to comments that are discussed throughout this chapter. To understand why XML comments are an essential topic, let’s take a look at a method invocation within the code editor. Figure 47.1 shows how IntelliSense appears on an uncommented method.

Image

FIGURE 47.1 Uncommented members make IntelliSense incapable of displaying useful information.

As you can see from Figure 47.1, IntelliSense ...

Get Visual Basic 2015 Unleashed now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.