Pytanie Dodawanie komentarzy do wyjścia WSDL z WCF / .Net


w oparciu o specyfikację WSDL z W3 istnieje możliwość dodania znaczników "wsdl: document" do wyjścia WSDL, aby osoby korzystające z tego serwisu miały lepsze wyjaśnienie / dokumentację na temat tego serwisu internetowego.

Czy ktoś wie, jak zrobić WCF używać tych komentarzy / opisów, lub jak napisać kod w C #, że te komentarze są eksportowane jako część wsdl?

Dzięki, Michael


22
2018-03-17 17:24


pochodzenie




Odpowiedzi:


Wygląda na to, że projekt społecznościowy WCFExtras na GitHub zapewnia obejście ograniczeń .NET 3.5.


11
2018-03-12 09:51



Po prostu wypróbowałem - działa jak urok, nawet jeśli moje rozwiązanie jest w .NET 4.0. Thanx Joannes - 4rchit3ct


http://msdn.microsoft.com/en-us/library/aa717040.aspx

Myślę, że to zrobi to, co chcesz, ale będzie działać tylko dla klientów .NET.


4
2018-06-27 23:47





Jeśli robisz swoje projektowanie / kodowanie w klasach C #, zdobione przez [ServiceContract] i [OperationContract], to niestety nie wiem, w jaki sposób można eksportować dokumentację, którą masz na temat tych klas i metod do WSDL, niestety.

Ja też byłem tym przerażony - spodziewałem się, że wszelkie komentarze /// na moich zajęciach i metodach pojawią się w WSDL - bez powodzenia :-(

Nasze rozwiązanie to teraz: 1) tworzymy podstawowe "makieta" naszego interfejsu serwisowego ze wszystkimi operacjami w C # 2) skompilujemy to do zespołu 3) wyodrębniamy metadane (WSDL, XSD) z tego zestawu, a następnie wyrzucamy prototyp C # " 4) ręcznie dodajemy komentarze (xs: adnotacja / xs: dokumentacja) do WSDL i XSD 5) od teraz WSDL / XSD to master - i generujemy nasz interfejs z tych opisów

Trudne i denerwujące, ale działa nam to całkiem dobrze.

Mam nadzieję, że VS2010 / WCF 4.0 przyniesie nam nieco więcej wsparcia w tej dziedzinie !!

Marc


3
2018-03-27 16:34



Wydaje się to dobrym podejściem. - Cheeso


WCF nie zrobi tego niestety na własną rękę. Istnieją punkty rozszerzalności dla generowania WSDL, których można użyć do wykonania tego przynajmniej częściowo: Wyszukaj w IWSDLExportExtension berło.

mam mały przykład o tym, jak wdrożyć proste rozszerzenie eksportu WSDL na mojej stronie, co może pomóc w rozpoczęciu pracy.


1
2018-03-18 02:02



Dzięki - ale to tylko pierwszy krok. To, co naprawdę chciałbym, to możliwość eksportu dowolnych "/// komentarzy ....", które zrobiłem w ServiceContract, OperationContract i DataContract do WSDL i XSD. Jakieś pomysły? - marc_s


[WebService(Namespace = "XXXXXXXXXXXXX", **Description**="V0.2.42")]

Opis umieścić, co chcesz w .NET 4.0, nie wiesz, które wersje ... Prawdopodobnie trochę za późno w odpowiedzi, ale odpowiedzi wydają się bardziej skomplikowane niż wymagane, aby dodać blurb do WSDL tylko dla programistów.


0
2018-04-30 22:02