Klient aplikacji API Azure nie generuje wyliczeń

Question

I hava swagger generowane przez Swashbuckle z mojej usługi WebApi. Wszystko wygląda dobrze pod względem typów i tak dalej ... Jednak generowanie klas proxy przy użyciu klienta aplikacji API Azure nie zawiera deklaracji enum. Kiedy dwukrotnie sprawdziłem, było to w swaggerze, ale w wynikowych klasach było tylko ich reprezentacja łańcuchowa (właściwość string zamiast enum property) i brak deklaracji typu enum.

Answer 1

W wersji AutoREST, która znajduje się na GitHub (https://github.com/Azure/AutoRest) i zostanie uwzględniona w przyszłej aktualizacji VS, przynajmniej wstawimy wartości wyliczeniowe jako komentarze dokumentacji XML. W ten sposób otrzymasz IntelliSense.

Powodem, dla którego na ogół odradzamy wyliczanie, jest uzasadnienie wersjonowania. Jeśli chcesz obsłużyć nową wartość wyliczeniową na serwerze, jest to przełomowa zmiana dla klienta.