6

Próbuję użyć tagów <see cref=""> w moich tagach dokumentacji XML dla mojego API, ale są one puste na stronach pomocy.Czy tagi dokumentacji XML nie są obsługiwane przez strony pomocy Web API 2?

Więc dla opisu chciałbym to powiedzieć: „Pobiera lub ustawia wartość dla skojarzonego poz

Gdzie Pozycja jest łączem do innego obiektu w interfejsie API.

Zamiast Dostaję:

„Pobiera lub ustawia wartość dla skojarzonego.”

Znacznik <see cref=""> jest ignorowany. Próbowałem nawet używać przykładów z here na wypadek, gdyby moja deklaracja była błędna, ale to też nie działało.

Czy ktoś jeszcze miał z tym problemy? Na jakim poziomie są tagi dokumentacji XML w nowych stronach pomocy Web API 2? Czy ktoś wie, czy możliwe jest ręczne dodanie obsługi, jeśli nie?

+0

Mamy ten sam problem, ale wszystkie posty na blogu dotyczące tego tematu wydają się być nieaktualne. – Remy

+0

Przedstawiam sposób na zrobienie tego na http://stackoverflow.com/questions/26177104/asp-web-api-help-pages-links-to-other-pages/26255631#26255631 –

Odpowiedz

0

nie miałem problemów z tym, ale proponuję Ci

  • Dodaj prosty przykładowy, który ilustruje zachowanie, wraz z wynikiem uzyskać

  • sprawdzić ostrzeżenia kompilacji, które mogą wskazują problemy z tagami dokumentacji XML.

Na przykład, można powiedzieć, że używasz <see cref=""> Czy wprowadzenie ważnego identyfikatora w atrybucie cref i zamykanie patrz tag - np <see cref="MyClass.MyMethod" />?

+0

Hej Joe, mamy to samo i wydaje się, że widzą to także inni ludzie. Jeśli masz jakieś wskazówki, od czego zacząć? – Remy

Powiązane problemy