Intellisense nie pokazuje XMLDOC dla odniesienia DLL

Question

Używam VS-2010 Ultimate wersja 10.0.30319.1 RTMRel (z o boxie).

Napisałem bibliotekę klas z dużą ilością ładnego XMLDOC (imho). Z powodów, dla których nie chcę wchodzić, gdy korzystam z tej biblioteki w różnych rozwiązaniach, sam projekt nie jest uwzględniony (jak w przypadku rozwiązania prawym przyciskiem, dodaj istniejący projekt ..); zamiast tego dodajemy odwołanie do biblioteki DLL, tak jakby była to biblioteka innej firmy.

W rozwiązaniu zawierającym bibliotekę intellisense działa normalnie i uzyskuję pełną korzyść z XMLDOC. Niestety, nie jest to miejsce, w którym będę go używał!

W innych rozwiązaniach, gdzie biblioteka jest tylko odnośnikiem DLL, otrzymuję intellisense, ale nie XMLDOC. Podczas gdy moja biblioteka jest na tyle zrozumiała, że ​​można jej używać bez kółek pomocniczych, zastanawiam się, dlaczego tak jest i czy jest coś, co mogę z tym zrobić.

Paragraf, który można pominąć: Mam nadzieję, że dość cyniczne podejrzenie, które przyszło mi do głowy, jest bezpodstawne, jak myślę, że - to znaczy, że M $ mogło "zablokować" tę funkcjonalność w pewien sposób, aby sprzedać dostęp do niej Niezależni twórcy bibliotek ... Przypuszczam, że jeden może zrobić coś takiego, jak wymagać podpisania pliku DLL przez dany klucz i oferować usługę on-pay, w której ludzie mogą podpisywać swoje biblioteki DLL za pomocą tego klucza, aby włączyć funkcjonalność, ale biorąc pod uwagę, jak cenne dla platformy jest posiadanie prężnych zewnętrznych twórców bibliotek i komponentów, wydaje się mało prawdopodobne, aby ktokolwiek się tym zajmował.

Czy ktoś ma jakieś wskazówki, jak podzielić się tym działaniem? Chciałbym, aby XMLDOC pojawiał się w intellisense za każdym razem, gdy używam tego, niezależnie od tego, jak. :)

Answer 1

Zestaw nie zawiera faktycznej dokumentacji komentarza. Musisz wygenerować plik XML, który zawiera całą twoją dokumentację.

Idź do ustawieniach projektów, na karcie Konstruowanie XML Documentation Check "File":

Teraz podczas kompilacji projektu, ładny plik XML zostanie wyprodukowany zawierające dokumentację.

W drugim projekcie należy odwołać się do biblioteki DLL i upewnić się, że kod XML ma taką samą nazwę jak zestaw z rozszerzeniem XML zamiast biblioteki DLL i znajduje się w tym samym katalogu, co biblioteka DLL, do której istnieje odniesienie. Na przykład:

Assembly: MyProject.dll

XML: MyProject.xml

Możesz dowiedzieć się więcej na temat dokumentacji XML at MSDN.