XML comments in the DLL not showing

[psycho]

I had created a class and added XML comments to its methods. Then I
compiled it as a DLL and added its reference to my project.

But when I type the names of its methods, the intellisense is not
showing XML comments. Am I doing something wrong or some other
attribute of the DLL needs to be set.

[Hans Kesting]

Re: XML comments in the DLL not showing

psycho expressed precisely :

I had created a class and added XML comments to its methods. Then I
compiled it as a DLL and added its reference to my project.
>
But when I type the names of its methods, the intellisense is not
showing XML comments. Am I doing something wrong or some other
attribute of the DLL needs to be set.

If you compile from within Visual Studio, there is a setting in the
project properties ('build' tab) to generate an XML documentation file
which is off by default.

If you use a command line compiler, there has a switch for it, but I
don't know what.

Hans Kesting

[Juan T. Llibre]

Re: XML comments in the DLL not showing

re:

If you compile from within Visual Studio, there is a setting in the project properties

!('build' tab) to generate an XML documentation file which is off by default.

IIRC, that only works with C# source files.

What really happens is that Visual Studio extracts comments
from the source code and creates an XML comments file.

The DLLs don't include the comments in them.

Here's a good explanation/tutorial :

http://msdn.microsoft.com/en-us/magazine/cc302121.aspx

Juan T. Llibre, asp.net MVP
asp.net faq : http://asp.net.do/faq/
foros de asp.net, en español : http://asp.net.do/foros/
=============== =============== ========
"Hans Kesting" <news.hansdk@sp amgourmet.comwr ote in message news:%23e2fFFmG JHA.4596@TK2MSF TNGP06.phx.gbl. ..

psycho expressed precisely :

>I had created a class and added XML comments to its methods. Then I
>compiled it as a DLL and added its reference to my project.
>>
>But when I type the names of its methods, the intellisense is not
>showing XML comments. Am I doing something wrong or some other
>attribute of the DLL needs to be set.

>
If you compile from within Visual Studio, there is a setting in the project properties ('build' tab) to generate an
XML documentation file which is off by default.
>
If you use a command line compiler, there has a switch for it, but I don't know what.
>
Hans Kesting
>
>

[Norm]

Re: XML comments in the DLL not showing

On Sep 17, 12:52 am, psycho <paramvir.d...@ gmail.comwrote:

I had created a class and added XML comments to its methods. Then I
compiled it as a DLL and added its reference to my project.
>
But when I type the names of its methods, the intellisense is not
showing XML comments. Am I doing something wrong or some other
attribute of the DLL needs to be set.

Disclaimer: VB.NET ... C# might do this a little differently

The intellisense does not run off of the XML comments. Intellisense
gets its info from attributes specified on the class. The one you are
referring to is the Description attribute. Theses types of attributes
are mostly in the System.Componen tModel namespace.

ex.

<Description("A rr matey,this be yer words here. Avast!")_
Public Class Pirate
Public isTodayNational TalkLikeAPirate Day as Boolean = True
....
....


Other attributes of note are the BrowsableAttrib ute,
BindableAttribu te, CategoryAttribu te, DefaultValueAtt ribute ...
nevermind, just browse the ComponentModel namespace.

Arr, may yer coding be full of bountiful treasure!
-Norm