Visual Studio Intellisense dla kreacji w Xml Documentation

Question

Podczas tworzenia dokumentacji XML dla metod C# w Visual Studio (używam 2010), otrzymasz wsparcie Intellisense do tworzenia różnych znaczników XML, takich jak zobacz, paramref itp. z drugiej strony, kiedy dodajesz atrybut aa cref, musisz użyć a, co moim zdaniem jest zawiłym formatem do opisu typów. Jest to najgorsze, gdy masz wiele leków generycznych.

Czego szukam, to co następuje. Jeśli ustawiasz atrybut cref w widocznym elemencie, masz listę klas IntelliSense, które pasują do tego, co wpisałeś, a następnie wypisujesz odpowiedni opis odpowiedniego typu. Lub gdy ustawiasz atrybut cref na elemencie paramref, otrzymasz listę parametrów tej metody.

Czy ktoś wie o jakimś dodatku do Visual Studio, aby zapewnić IntelliSense dla tych atrybutów cref?

Answer 1

Ostatnio pisałem dużo dokumentacji XML i myślę, że ReSharper oferuje funkcjonalność, której szukasz dzięki rozszerzonej funkcji IntelliSense Code Completion - używam jej przez cały czas. Funkcja Quick Documentation nie może być pomijana podczas pisania dokumentacji - z nią można zobaczyć, jak będzie wyglądała dokumentacja XML po kompilacji do html/chm, i jest aktualizowana w czasie rzeczywistym, więc jeśli zmienię coś w dokumenty z oknem Szybkiej dokumentacji są widoczne, widzę, że zmienia się automatycznie - naprawdę przydatne w formatowaniu i tym podobne.

Jeśli dodać Agent Smith do mieszanki (które działa tylko jako dodatek do ReSharper, najwyraźniej), można dodać trochę poręczny sprawdzanie pisowni, XML Komentarz Validation, nazywając kontroli Konwencji oraz kilka prostych komentarz -przepływ (jeśli zależy ci na utrzymaniu określonej liczby znaków/linii) (przy czym pierwsze dwa prawdopodobnie są najbardziej przydatne, ponieważ ReSharper zapewnia możliwość egzekwowania konwencji nazewnictwa).

Nadzieję, że pomaga!