473,396 Members | 1,726 Online
Bytes | Software Development & Data Engineering Community
Post Job

Home Posts Topics Members FAQ

Join Bytes to post your question to a community of 473,396 software developers and data experts.

XML documentation on an interface

Hi I wrote an interface and a class which implements this interface.

I documented the interface methods of the interface.
In a third class I tried the following
IInterface myIntf = new CClass(); //CClass implements IIinterface
if I now press
myIntf.DoSomething


I expected a tooltiptext whith the <summary> of the interface method.
Unfortunately it shows nothing but the name, parameters and return
value.

Why?

Nov 17 '05 #1
7 1965
PS: This effect occurs, if the interface is in another assembly then
the interface implementing class

Nov 17 '05 #2
Karsten,

If the interface is in another assembly, then did you generate the XML
documentation for that assmbly? You need to have the /doc switch (for
command line builds) set, or the setting in the project properties set to
generate the XML documentation (look at the project properties). Once you
built it, you need to name the file the same name as the assembly, but with
an XML extension.

If you have done all of this, you then make sure that this file is in
the same directory as the assembly is (which you have a reference to), and
then you should see the documentation.

Hope this helps.
--
- Nicholas Paldino [.NET/C# MVP]
- mv*@spam.guard.caspershouse.com

"Karsten Schramm" <Ne**********************@yajirobi.de> wrote in message
news:11**********************@g47g2000cwa.googlegr oups.com...
PS: This effect occurs, if the interface is in another assembly then
the interface implementing class

Nov 17 '05 #3
Yeah thanks, it works. But only if the reference is on "local copy =
true". Is that correct?

Nov 17 '05 #4
Karsten,

Either way, the XML documentation file has to be in the directory that
the assembly is in that the reference is set to. Setting local copy = true
means that the assembly is copied to the output directory when it is
compiled, and shouldn't affect the search for the XML documentation file.
--
- Nicholas Paldino [.NET/C# MVP]
- mv*@spam.guard.caspershouse.com

"Karsten Schramm" <Ne**********************@yajirobi.de> wrote in message
news:11**********************@g49g2000cwa.googlegr oups.com...
Yeah thanks, it works. But only if the reference is on "local copy =
true". Is that correct?

Nov 17 '05 #5
Nicholas Paldino [.NET/C# MVP] schrieb:
Karsten,

Either way, the XML documentation file has to be in the directory that
the assembly is in that the reference is set to. Setting local copy = true
means that the assembly is copied to the output directory when it is
compiled, and shouldn't affect the search for the XML documentation file.


Yeah, but it does. I tried it in a mini project.

Please download and build

http://doena-soft.de/upload/TestXMLD...Copy_False.rar

http://doena-soft.de/upload/TestXMLD...lCopy_True.rar

After build I cannot see the documention if localcopy = false

Nov 17 '05 #6

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

75
by: Xah Lee | last post by:
http://python.org/doc/2.4.1/lib/module-re.html http://python.org/doc/2.4.1/lib/node114.html --------- QUOTE The module defines several functions, constants, and an exception. Some of the...
5
by: BoonHead, The Lost Philosopher | last post by:
Does anyone know how to implement internal interface documentation for functions and parameters? I found a similair thing for proerties. For properties I found something like:...
1
by: Burkhard Perkens-Golomb | last post by:
Hi, I've a question about XML documentation of overridding methods and methods implementing an interface declaration: These methods are normally documented in the base class or interface. So I...
5
by: BoonHead, The Lost Philosopher | last post by:
Does anyone know how to implement internal interface documentation for functions and parameters? I found a similair thing for proerties. For properties I found something like:...
0
by: Charles Arthur | last post by:
How do i turn on java script on a villaon, callus and itel keypad mobile phone
0
by: emmanuelkatto | last post by:
Hi All, I am Emmanuel katto from Uganda. I want to ask what challenges you've faced while migrating a website to cloud. Please let me know. Thanks! Emmanuel
1
by: nemocccc | last post by:
hello, everyone, I want to develop a software for my android phone for daily needs, any suggestions?
1
by: Sonnysonu | last post by:
This is the data of csv file 1 2 3 1 2 3 1 2 3 1 2 3 2 3 2 3 3 the lengths should be different i have to store the data by column-wise with in the specific length. suppose the i have to...
0
marktang
by: marktang | last post by:
ONU (Optical Network Unit) is one of the key components for providing high-speed Internet services. Its primary function is to act as an endpoint device located at the user's premises. However,...
0
by: Hystou | last post by:
Most computers default to English, but sometimes we require a different language, especially when relocating. Forgot to request a specific language before your computer shipped? No problem! You can...
0
by: Hystou | last post by:
Overview: Windows 11 and 10 have less user interface control over operating system update behaviour than previous versions of Windows. In Windows 11 and 10, there is no way to turn off the Windows...
0
tracyyun
by: tracyyun | last post by:
Dear forum friends, With the development of smart home technology, a variety of wireless communication protocols have appeared on the market, such as Zigbee, Z-Wave, Wi-Fi, Bluetooth, etc. Each...
0
agi2029
by: agi2029 | last post by:
Let's talk about the concept of autonomous AI software engineers and no-code agents. These AIs are designed to manage the entire lifecycle of a software development project—planning, coding, testing,...

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.