Page 1 of 1

How do you include C# doc comments in DLL files?

Posted: Mon Apr 14, 2014 3:34 pm
by MatthiasT
Hi there,

we have created our own dll file with common operations and a repository. It is meant to be used by other test suites. In the source code of the c# files, I added c# documentation comments to all the public classes and methods like this:

Code: Select all

/// <summary>
/// Returns an instance of the designer and connects to the zeb//control server defined in the central database.
/// Will create (start) a new designer instance if none exists.
/// </summary>
public void getDesignerWithLogin() {
/*...*/ 
}
I've also activated the generation of doc comments (at least I think so) in the settings of the project.
doccomments.JPG
The resulting xml file is copied along with the dll file when the library is referenced from a test suite.

However, when I'm using methods from the dll file, the doc comments are not shown.

How can I fix this?

Thanks!

Best,

Matthias

Re: How do you include C# doc comments in DLL files?

Posted: Wed Apr 16, 2014 1:46 pm
by Support Team
Hello Matthias,

Please ensure that the XML-File is in the same folder as the referenced *.dll-file.
If the issue still occurs I may ask you which Ranorex version you are currently using.

Regards,
Robert

Re: How do you include C# doc comments in DLL files?

Posted: Wed Apr 16, 2014 3:09 pm
by MatthiasT
Hi Robert,

I just checked again - funnily enough it's working now. ;) Don't know what went wrong before.

I'm using Ranorex 5.0.1.17706 btw.

@everybody who might experience this in the future: Put the xml file with the doc comments next to the dll before referencing the dll file.

Best,

Matthias